必须安装作者为ms-vscode的doxygen documentation generator插件，仅此版本支持c/c++函数参数名自动识别；需配置@param/@return标签、触发序列为/**、光标须紧贴函数声明上方无空行，且文件头与函数注释模板须分开设置。
Doxygen Documentation Generator插件必须装对版本
VSCode市场里搜到的同名插件不止一个，但只有作者是ms-vscode的那个才真正支持C/C++函数注释的上下文识别。第三方插件常把@param字段名硬编码成param1、param2，根本不会读取你函数声明里的真实参数名。装错后按快捷键生成的注释看着像模像样，实际@param a和函数签名里的int a对不上，doxygen解析时直接跳过整个块。
安装完务必重启VSCode，否则Ctrl+Win+T（Windows）或Cmd+Option+T（macOS）可能无响应——这不是快捷键冲突，而是插件服务没加载。
函数注释模板必须匹配C/C++语法细节
默认模板用\param和\return，但多数C/C++项目约定用@param和@return。不改的话，生成的注释会被doxygen当成普通文本忽略。改法很简单：打开settings.json，加这两行：
"doxdocgen.c.paramTag": "@param", "doxdocgen.c.returnTag": "@return"
另外三个容易被忽略的点：
-
doxdocgen.c.triggerSequence设为"/**"，不是"/** "（末尾空格会导致触发失败） - 如果函数返回
void，模板里@return字段会照常生成，得手动删掉——插件目前不自动判断返回类型 - 指针参数如
char* buf，模板默认生成@param buf，但规范写法应是@param buf [out] 缓冲区地址，需在模板里加[in]/[out]占位符并手动补全
光标位置决定注释能否正确绑定到函数
快捷键只在光标位于函数定义行正上方、且与函数声明之间**零空行**时生效。常见失效场景：
- 光标在函数体第一行（比如
{那行）——插件找不到上一行的函数签名，生成空模板 - 函数声明和注释块之间有空行——doxygen解析时认为这是独立注释，不关联函数
- 函数在
.c文件里实现，但注释写在.h头文件外——doxygen默认只索引头文件中的声明，.c里的注释即使格式正确也不进文档
正确做法：把光标停在int foo(int a, char* b);这行正上方，按Ctrl+Win+T，它才能准确提取a和b作为@param字段名。
文件头注释和函数注释要分开配，不能共用一套模板
文件头需要@copyright、@author、@date，函数注释需要@brief、@param、@return，混用会导致字段错乱。比如把文件头模板套给函数用，会生成一堆@copyright，而漏掉@param。
配置时明确区分：
- 文件头用
doxdocgen.file.*前缀的设置项，比如doxdocgen.file.copyrightTag - 函数注释用
doxdocgen.c.*前缀，比如doxdocgen.c.briefTag - 快捷键也不同：
Ctrl+Win+I是文件头，Ctrl+Win+T才是函数——手快按错一次，就得手动删掉整个注释块
最麻烦的是@brief字段：它必须独占一行且后面紧跟空行，否则doxygen会把后续所有文字都吞进brief里。模板里别写成"@brief ${1:brief} ${2:description}"，而要强制换行："@brief ${1:brief}\n\n${2:description}"。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
