Ctrl+/和/**回车失效主因是JSDoc插件冲突：Document This、koroFileHeader、CodeGeeX等争抢editor.action.commentLine命令或onType触发权，导致命令被静默拦截；Python需配python.docstringGenerator.style，koroFileHeader中文模板须用英文变量名。
Ctrl+/ 注释失效、/** 回车不生成 JSDoc、中文注释模板乱码——大概率不是插件坏了，而是多个 JSDoc 相关插件在抢同一块地盘。
为什么 /** 回车没反应，连带 Ctrl+/ 也失灵？
这不是 VSCode 抽风，而是触发链被卡住了：JSDoc 自动补全依赖语言服务 + 光标位置 + 插件注册权三者同时就位。一旦有插件（比如 Document This、koroFileHeader、CodeGeeX）同时监听 onType 或注册了 editor.action.commentLine 命令，VSCode 就会丢弃后加载的那个——你看到的“没反应”，其实是命令被静默拦截了。
常见诱因包括：
- Document This 和 koroFileHeader 同时启用：前者只支持 JS/TS，后者通吃但会劫持所有
/**触发逻辑 - CodeGeeX 开启了“自动插入函数注释”且设为中文，但它和 VSCode 内置 JSDoc 补全共用同一触发时机，结果谁也不生效
- Python 文件里
"""回车无效，除了没配python.docstringGenerator.style，还可能因为 pylance 启用了自己的 docstring 补全，和autoDocstring插件打架
怎么快速定位哪个插件在抢 JSDoc 控制权？
别猜，直接看 VSCode 的“裁判日志”：
按 Ctrl+Shift+P 输入 Developer: Toggle Developer Tools，切换到 Console 标签页，然后在任意 JS/TS 文件里敲 /** 并回车。如果控制台刷出类似 Command 'javascript.showJSDocComment' is already registered 或 Conflict detected for command 'editor.action.commentLine' 的红字，说明冲突已坐实。
再配合 Developer: Show Running Extensions 看哪些插件正在活跃加载——重点盯住名字带 jsdoc、docstring、comment、header 的扩展，它们最可能越界。
koroFileHeader 是唯一能稳住中文模板的方案吗？
是的，但它稳的前提是你别乱改它的模板语法。koroFileHeader 不走语言服务路线，靠纯文本模板 + 变量替换驱动，所以不受 TypeScript 解构参数或箭头函数体解析失败的影响。
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
但很多人踩坑在：$description$ 这类占位符必须用英文命名，不能写成 $功能说明$ 或 $说明$——插件压根不认识，结果生成出来全是原样字符串。
另外，它默认不接管 /** 触发，得手动打开配置：
- 在 settings.json 中加
"koroFileHeader.configObj": { "supportAutoAdd": true } - 确保
"files.associations"里把.ts、.js、.py映射对了语言模式，否则模板不会加载 - Python 用户仍需保留
python.docstringGenerator.style设置，否则"""回车还是挂
Ctrl+/ 快捷键失效，真和 JSDoc 插件有关？
有关，而且很直接。很多 JSDoc 插件（尤其是旧版 autoDocstring、vscode-jsdoc）会在激活时偷偷重绑定 editor.action.commentLine，覆盖掉 VSCode 默认行为。你按 Ctrl+/，实际执行的是插件注册的副本，而那个副本可能没做兼容处理，一遇到 JSX、TSX 或 Markdown 块就直接静音。
验证方式很简单：终端运行 code --disable-extensions，打开一个 .js 文件，试试 Ctrl+/。如果恢复正常，再进键盘快捷方式面板（Ctrl+K Ctrl+S），搜 comment，看“添加行注释”右侧是否显示“来自扩展”，点开就能看到是哪个插件在 hijack。
修复建议：
- 禁用所有带
comment、docstring、jsdoc的插件，只留 koroFileHeader（它不劫持快捷键） - 手动在 keybindings.json 中强制指定默认行为：
[{"key": "ctrl+/", "command": "editor.action.commentLine", "when": "editorTextFocus && !editorReadonly"}] - 避免同时启用 Prettier 和 ESLint 的“保存时注释自动对齐”选项，它们会干扰注释符号位置判断
真正麻烦的不是模板写不中文，而是多个插件对同一触发时机的争夺——一旦注册冲突发生，VSCode 不报错、不提示，只默默丢弃后续请求。所以别迷信“装得多=功能强”，JSDoc 场景下，一个干净的 koroFileHeader + 正确的占位符命名 + 关闭其他同类插件，比五个插件叠在一起更可靠。
