doxygen documentation generator 插件需正确配置才能生成标准注释：触发序列应为"/**"，光标须位于c/c++符号定义正上方，依赖c/c++扩展提供语义信息，且注释块须紧贴定义无空行，doxyfile中extract_all和input路径需合理设置。
Doxygen Documentation Generator 插件能直接在 VSCode 里生成符合 Doxygen 标准的注释，但它本身不校验注释是否合法，也不生成最终文档——那得靠系统级 doxygen 命令和正确的 Doxyfile 配置。
为什么输入 /** 后没反应？触发机制被关了或配错了
插件默认只在光标位于函数/结构体/变量定义正上方时才响应 /** + 回车。常见失效原因：
-
doxdocgen.c.triggerSequence被设成"/*"或空值，应保持为"/**" - 当前文件后缀未被识别为 C/C++（比如是
.h但 VSCode 没激活 C/C++ 扩展），检查右下角语言模式是否显示C或C++ - 光标不在“可识别符号上方”：例如写在
if块里、宏展开后的位置、或函数体内而非声明行上方 - 插件配置中
doxdocgen.generic.language错设为python，而当前是 C 文件
函数注释里 @param 缺失或顺序错乱？类型推导依赖语言服务
插件会读取当前光标所在行的函数签名，调用 VSCode 的 C/C++ 扩展提供的语义信息来提取参数名和类型。如果 @param 行缺失或错位，通常是因为：
- C/C++ 扩展未启用或崩溃（看左下角有没有报错提示）
- 函数声明跨多行（如参数分行写），插件只解析单行声明；建议把声明写在一行，或手动补全
@param - 用了 typedef 类型或宏定义的参数（如
MY_STATUS），插件无法展开，@param名会为空或错乱 -
doxdocgen.generic.includeTypeAtReturn设为false，会导致@return不带类型，但不影响@param生成
文件头注释不带版权信息？copyrightTag 必须手写进 settings.json
UI 设置界面里填的 Author Name 和 Email 只影响 @author 字段，@copyright 需要显式配置 doxdocgen.file.copyrightTag，且必须是数组格式：
"doxdocgen.file.copyrightTag": [
"@copyright Copyright (c) {year} YourCompany",
"@version 1.0.0"
]
注意：{year} 是插件支持的占位符，会自动替换为当前年份；{author} 同理，但前提是 doxdocgen.generic.authorName 已设置。
生成的注释被 Doxygen 忽略？检查注释块位置和 Doxyfile 配置
即使注释语法完全正确，doxygen 命令仍可能跳过它们——最常被忽略的两个点：
- 注释块必须紧贴符号定义上方，中间不能有空行（
/** */和int func();之间不能有空白行） -
Doxyfile中的EXTRACT_ALL = NO（默认值），意味着只提取带注释的符号；若想强制提取所有，需改为YES，但更推荐给每个公开接口补上注释 -
INPUT路径没包含头文件目录（如只写了./src却漏了./include），导致.h里的函数声明注释不被扫描
真正卡住人的地方往往不是插件怎么用，而是 doxygen 命令跑起来之后，HTML 输出里某几个函数始终不出现——这时得回头查注释块和定义之间的物理距离，以及 Doxyfile 里那几行看似不起眼的路径和开关设置。
