VSCode 自动生成中文注释需依赖插件与正确配置：koroFileHeader 是唯一不依赖语言服务、直写中文模板且快捷键稳定的方案；DocumentThis 对解构参数和箭头函数失效；Better Comments 仅美化不生成。
VSCode 本身不生成中文注释，能用中文写注释、还能自动生成的，全靠插件选得对、配得准——koroFileHeader 是目前唯一不依赖语言服务、模板直写中文、快捷键稳定触发的方案；DocumentThis 虽快但对解构参数和箭头函数失效；Better Comments 只管样式，不管生成。
为什么 /** 回车没反应？JSDoc 触发条件卡死在这里
这不是插件问题，是 VSCode 的 JSDoc 行为有硬性前提：
- 当前文件右下角语言模式必须是
javascript、typescript或python，不能是Plain Text或未识别类型 - 光标必须落在函数声明行（如
function getUser(id) {）或其正上方空行，不能在函数体内、注释块中间、或 JSX 标签里 - TypeScript 中若用
DocumentThis，它不识别解构参数（如({ id, name }) => {}），会漏字段；也不处理表达式体的箭头函数（如const fn = () => "ok"） - Python 场景下，
python.docstringGenerator.style必须设为google、numpy或restructuredtext之一，否则"""回车无效
koroFileHeader 配置中文模板最稳，但变量名仍得用英文
它靠模板+变量驱动，不依赖语言服务，所以中文支持最可靠。但注意：模板里字段描述可用中文（比如把 Description 改成“功能说明”），变量名必须用英文占位符（如 $description$），否则插件无法替换。
- 在
settings.json中加这段（注意双引号转义）：
{
"fileheader.customMade": {
"Author": "张三",
"Date": "Do not edit",
"Description": ""
},
"fileheader.configObj": {
"autoAdd": true,
"annotationStr": {
"head": "//",
"middle": "//",
"end": "//"
}
}
}- 新建文件按
Ctrl+Alt+I插入文件头；光标停在函数定义行按Ctrl+Alt+T生成函数注释 - 若想让
@param后面带中文提示（如@param {string} id - 用户ID），需在fileheader.cursorMode里手动补全字段，插件不会自动推断语义
快捷键失效？先看这三件事有没有做错
不是快捷键坏了，大概率是环境状态不对：
- 右下角显示
Plain Text→ 点击它，手动选JavaScript或保存为.js后缀 - 输入法是中文 → 切回英文再按
Ctrl+/，否则实际触发的是中文顿号「、」 - 快捷键被覆盖 → 打开
Ctrl+K Ctrl+S搜toggle line comment，检查是否被vim、prettier或auto rename tag劫持 -
Shift+Alt+A在 JSX/TSX 中可能无响应，此时优先用koroFileHeader的Ctrl+Alt+T替代
中文注释乱码？编码和字体两头都要盯
乱码不是注释写错了，是 VSCode 没正确读取或渲染：
- 文件本身是 GBK 编码，而 VSCode 默认用 UTF-8 打开 → 点右下角
UTF-8，选Reopen with Encoding→GBK或GB2312 - 勾选
Auto Guess Encoding（设置里搜这个）可缓解，但不能根治跨平台协作时的编码混杂 - 字体不支持中文 → 设置里搜
editor.fontFamily，改成"Fira Code", "Microsoft YaHei", "monospace"这类含中文字体的组合 - 终端输出中文乱码？在集成终端输
chcp 65001（Windows）临时切 UTF-8，但真正要解决得统一项目文件编码
真正麻烦的不是怎么写中文注释，而是团队里有人用 koroFileHeader 自动生成，有人手敲 /** */，还有人混用 # 和 //——格式化工具一跑，注释位置偏移、嵌套崩塌、甚至被删掉关键说明。这些细节不报错，但会让下次读代码的人多花三分钟确认原意。
