插件下载
Visual Studio Code 上快捷生成 doxygen 格式注释需要使用插件，推荐插件：cschlosser.doxdocgen，插件名全称 ：Doxygen Document Generator，如下图
插件下载地址： https://marketplace.visualstudio.com/items?itemName=cschlosser.doxdocgen
安装配置
下载完成后，打开 Visual Studio Code，点击界面左侧的扩展，接着扩展栏右上角的 ... 按钮，在下拉菜单中选择菜单底部的 " 从 VSIX 安装... (Install from VSIX...) "，找到下载好的文件进行安装。
安装完成后，进入插件的扩展设置 (扩展页插件右下角的齿轮) → " 扩展设置 (Extension Settings) "。
如需要生成注释格式为
/// @brief
/// @param [入参]
/// @return
则应如下操作
- Doxdocgen > C: Comment Prefix 设置为
///，三斜杠后留一个空格。
此设置项为每行注释的起始字符，若另一种类型注释则可保持默认的* - Doxdocgen > C: First Line 与 C: Last Line 清空
- Doxdocgen > C: Trigger Sequence
此项为触发生成的按键，可以保持默认 - Doxdocgen > Generic: Order 此项为生成顺序，进入 Edit in settings.json 设置为如下内容
"doxdocgen.generic.order":[
"brief",
"param",
"return"
]
- Doxdocgen > Generic : Param Template 设置为
@param [入参] {param}
此扩展完整的 settings.json 配置为：
{
"doxdocgen.generic.paramTemplate": "@param [入参] {param} ",
"doxdocgen.c.commentPrefix": "/// ",
"doxdocgen.c.firstLine": "",
"doxdocgen.c.lastLine": "",
"doxdocgen.generic.order":[
"brief",
"param",
"return"
]
}
设置颜色
Visual Studio Code 中一般注释与 doxygen 注释的设置不同，要修改 doxygen 注释颜色，此处需要打开 vscode 的 settings.json 文件，需要进入 " 命令面板 (Command Palette...) "，vscode 左下角的设置按钮，菜单第一个选项，或者直接使用快捷键 Ctrl + Shift + P 。
打开面板后，输入 Settings, 查找并点击 " Preferences: Open User Settings "
将如下内容粘贴到 settings.json 文件中，并保存
{
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope" : [
"comment.block.documentation.cpp",
"comment.line.double-slash.documentation.cpp",
"storage.type.class.doxygen"
],
"settings": {
"foreground": "#504fa2",
"fontStyle": "bold"
}
}
]
}
}
前两项的 scope 内容为 doxygen 注释
后一项的 scope 内容为 doxygen 标签 如 param ,brief 等。也可以设置为不同的颜色。
关于 doxygen 注释设置的完整 settings.json 文件，如下
{
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope" : [
"comment.block.documentation.cpp",
"comment.line.double-slash.documentation.cpp",
"storage.type.class.doxygen"
],
"settings": {
"foreground": "#504fa2",
"fontStyle": "bold"
}
}
]
},
"doxdocgen.generic.paramTemplate": "@param [入参] {param} ",
"doxdocgen.c.commentPrefix": " /// ",
"doxdocgen.c.firstLine": "",
"doxdocgen.c.lastLine": "",
"doxdocgen.generic.order":[
"brief",
"param",
"return"
]
}
此时，在代码中输入触发 /** 后回车即可看到自动生成的 doxygen 格式的注释如下，且与常规的注释颜色有区分
查看范围
关于 settings.json 中的 scope 如何查看，一样 Ctrl + Shift + P 打开 " 命令面板 (Command Palette) "，查找并选择 " Developer: Inspect Editor Tokens and Scopes "，鼠标放在想知悉的元素上，即可知如下图查看其 scope。
参考链接：https://stackoverflow.com/questions/45195023/how-do-i-change-color-of-comments-in-visual-studio-code
其他链接：
Visual Studio Code 官网插件下载地址: https://marketplace.visualstudio.com/vscode
