doxygen documentation generator插件仅生成注释模板，依赖本地doxygen命令解析符号、填充@param等字段；若doxygen未加入path，插件将静默失败。
Doxygen Documentation Generator 插件必须搭配本地 doxygen 命令才能用
插件本身不生成文档，只负责写注释模板；真正解析符号、推断参数、填充 @param 和 @returns 的是系统里装的 doxygen 可执行文件。没它，插件连预览都出不来，所有“一键生成”都会静默失败。
常见错误现象：doxygen -v 在 VS Code 内置终端报 command not found；快捷键 Alt+Shift+D 按下后无反应；右下角语言模式明明是 C++，但光标停在函数上方仍不触发。
- macOS：运行
brew install doxygen，再执行doxygen -v确认输出类似1.9.8 - Windows：下载官方安装包（如
doxygen-1.9.8-setup.exe），安装时务必勾选Add doxygen to PATH，装完重启 VS Code 终端 - Linux：运行
sudo apt install doxygen（Ubuntu/Debian），然后验证which doxygen是否返回路径
Document This 插件对 JS/TS 最友好，但不支持 C/C++ 函数签名解析
它能直接读取 function foo(a: string, b?: number): boolean 这类签名，自动填出 @param 类型和 @returns 类型，还能识别 JSDoc 已有字段避免重复。但遇到 C 函数如 int calc(int x, char *buf)，它只会生成空占位符，@param 字段全为空——因为没做 C 语法解析器。
使用场景：适合前端、Node.js、TS 项目快速补注释；不适合嵌入式、驱动或纯 C/C++ 项目。
- 触发方式优先用
/**+Tab，比快捷键Ctrl+Alt+D更稳定 - 光标必须严格落在函数名正上方一行，不能在函数体内、注释行或空行中间
- 若生成后
@param缺失，检查当前文件右下角语言模式是否为TypeScript或JavaScript，不是就点它手动切
Doxygen 插件的 @brief 和 @param 字段容易被忽略格式细节
Doxygen 默认生成的是 /// \brief 风格（Q#、C++ 常用），但很多 C 项目习惯用 /** ... */ + @brief。插件默认输出不带换行、不缩进，导致后续手写内容难对齐，也影响 Doxygen 解析。
参数差异直接影响生成质量：
-
doxdocgen.c.triggerSequence设为/**才能在 C 文件中触发块注释，设成///就只响应行注释 -
doxdocgen.generic.dateFormat建议设为YYYY-MM-DD，避免%Y-%m-%d在某些 locale 下崩掉 - 如果函数有指针参数如
char *path，插件默认生成@param path，但 Doxygen 实际需要@param[in] path才标记输入方向——这个得手动补
Markdown All in One 的目录生成和 Document This 不冲突，但要分清职责
前者管项目级文档（README.md、设计文档），后者管代码内联注释。两者共存时容易误操作：比如在 .md 文件里按 /** + Tab，Document This 会试图解析 Markdown 标题当函数名，结果生成一堆无效 @param。
容易踩的坑：
- 在 Markdown 文件里触发 Document This，会生成错乱注释；应关掉该语言模式下的插件，或用
"[markdown]": { "editor.quickSuggestions": false }屏蔽 -
Create Table of Contents命令默认插入到光标位置，不是文件开头；如果想固定放顶部，得先 Ctrl+Home 再执行 - 中文标题生成的锚点是 URL 编码（如
#%E5%87%BD%E6%95%B0），点击跳转正常，但复制链接给别人看会显得不专业——建议配合markdown.extension.toc.slugifyMode设为github
复杂点在于：注释生成不是“按个键就完事”，而是要先理清语言、工具链、输出目标三者匹配关系。比如 C 项目用 Document This 就是缘木求鱼，而 JS 项目硬套 Doxygen 插件又多一层配置负担。选哪个，得看代码写在哪、文档导出给谁看、要不要进 CI 流水线。
