<p>VS Code中/** + Enter未生成JSDoc，主因是文件后缀非.js/.ts、语言模式为Plain Text、或光标未紧贴函数声明行开头；Document This插件已停更兼容性差，推荐改用vscode-jsdoc；Doxygen插件失效多因系统未安装doxygen或未加入PATH。</p>
VSCode 里按快捷键没生成 JSDoc 或 Doxygen 注释，大概率不是操作错了，而是插件没装对、语言模式没切对、或光标位置不对——这些点卡住，再按一百次也没用。
为什么 /** + Enter 没反应？检查三件事
VSCode 自带的 JavaScript/TypeScript 支持只在满足条件时才触发 /** 补全：文件后缀必须是 .js 或 .ts；右下角语言模式必须显示 JavaScript 或 TypeScript（不是 Plain Text）；光标得紧贴函数声明行开头（不能缩进、不能空格、不能在函数体内）。
- 如果右下角显示
Plain Text，点击它 → 选JavaScript或TypeScript - 如果写的是
const fn = () => {}，/**默认不识别——改用function fn()再试 - 装了插件但没重启 VSCode？执行
Developer: Reload Window（Ctrl+Shift+P 输入）
Document This 插件为啥 Ctrl+Alt+D 失效？
Document This 已停更，新版 VSCode 中兼容性变差，尤其在 TS 项目里常漏掉参数类型、返回值推导不准。它也不支持解构参数（如 ({ a, b }) => {}），生成的 @param 全是 {any}。
- 替代方案：装
vscode-jsdoc（作者spmeesseman），它专注 JSDoc，对 ES6+ 函数签名解析更稳 - 快捷键冲突？打开
Preferences: Open Keyboard Shortcuts，搜document this，删掉旧绑定，或直接用/**+Enter - 想补作者/日期字段？Document This 的设置项叫
documentThis.author和documentThis.dateFormat，别填错名字
Doxygen Documentation Generator 插件报 command not found？
这个插件本身不生成文档，只写注释模板；真正干活的是系统里的 doxygen 命令。插件静默失败，90% 是因为 doxygen 没装进 PATH。
- macOS：运行
brew install doxygen→ 再跑doxygen -v看是否输出版本号 - Windows：安装时务必勾选
Add doxygen to PATH，装完重启 VS Code 终端 - Linux：用
sudo apt install doxygen（Ubuntu/Debian），然后验证which doxygen - VS Code 内置终端里
doxygen -g Doxyfile报错？说明上一步没走通，别往下配插件了
Python 函数 docstring 怎么一键生成？
Python 推荐用 Python Docstring Generator 插件，它能识别 Google/NumPy/Sphinx 多种格式，且支持类型猜测（比如从 def foo(x: str) -> int: 推出 @param x: 和 @return:）。
- 快捷键默认是
Ctrl+Alt+D（Win/Linux）或Cmd+Alt+D（macOS），光标必须放在def行正上方 - 想用 Google 风格？在
settings.json里加："autoDocstring.docstringFormat": "google" - 如果函数用了
*args或**kwargs，插件通常不生成对应@param—— 这是设计使然，得手动补
最易被忽略的其实是语言模式和光标位置：哪怕插件全装对、命令全可用，光标偏移一个字符，或者文件没认成对应语言，整个流程就断在第一步。别跳过验证环节，先确保 doxygen -v 或 doxygen --version 能跑通，再调插件。
