koroFileHeader插件通过JSON配置实现中文注释模板自动插入，需在settings.json中设置fileheader.customMade和fileheader.configObj，支持.vue等自定义后缀，按Ctrl+Alt+i触发，字段如Author、Date、Description可自动填充且日期动态更新。
中文注释模板怎么自动插入
靠手敲函数头注释或文件头注释，既慢又容易漏字段。koroFileHeader 是目前最稳的模板驱动型插件，它不依赖 AI，纯靠配置生效，适合对注释结构有强要求的团队。
安装后默认只对 .js、.ts、.py 等常见语言生效；如果要在 .vue 或自定义后缀（如 .tsx）里也触发，得手动加配置：
- 按
Ctrl+Shift+P输入Preferences: Open Settings (JSON) - 在
settings.json里加这段：
{
"fileheader.customMade": {
"Author": "your-name",
"Date": "Do not edit",
"LastEditTime": "Do not edit",
"Description": ""
},
"fileheader.configObj": {
"createFileTime": true,
"language": {
"vue": {
"head": "/**",
"middle": " * @",
"end": " */"
}
}
}
}保存后新建 .vue 文件，按 Ctrl+Alt+i 就能插入带作者、时间、描述字段的注释块。
注释分类着色怎么配才不干扰阅读
Better Comments 的核心价值不是“好看”，而是让 TODO、FIXME、NOTE 这类语义化标记一眼可辨。但默认配色（尤其红色 !）容易和错误提示混淆，建议重置：
- 打开设置 → 搜索
Better Comments→ 找到Custom Comment Tags - 把原生的
!标签删掉，换成更中性的⚠️或❗（注意用 Unicode 字符，不是英文感叹号） -
TODO保留蓝色，FIXME改成橙色，NOTE用绿色——这组对比度高、色盲友好
别忘了关掉 Highlight Plain Comments，否则所有普通 // 注释都会被染色，反而降低信息密度。
AI 自动生成注释时为什么经常翻车
CodeGeeX 和通义灵码这类插件确实能一键生成函数注释，但实际落地常出问题：
- 输入是
function getUserById(id) { ... }，输出可能是“获取用户信息”，完全没提id是必填参数、返回值类型、可能抛错场景 - 遇到复杂逻辑（比如 Promise 链嵌套 + 条件分支），AI 常把副作用当主逻辑，注释重点偏移
- 中文训练数据若含大量低质开源项目注释，模型会学坏——比如把
// 处理数据当标准模板反复套用
实操建议：只对纯数据转换类函数（如 formatDate、deepClone）开 AI 注释；业务层函数必须人工补全参数约束、边界条件、调用方责任三要素。
注释翻译插件为啥 hover 不出结果
Comment Translate 插件依赖网络 API，默认走 Google，国内环境大概率超时失败。不报错，但 hover 没反应，容易误判为插件失效。
- 先确认右下角状态栏是否显示
Comment Translate: Ready，没显示说明服务没启起来 - 打开插件设置，把
Comment Translate: Provider改成Baidu或DeepL（需填DeepL API Key） - 检查当前光标是否真落在注释内：它只识别
//、/* */、#、<!-- -->四种语法，ES6 模板字符串里的注释不算
真正麻烦的是多行注释跨行翻译——比如 /**\n * @param {string} name 用户名\n * @returns {Promise}\n */，插件会把整个块当一句处理，结果译文生硬。这种场景不如直接复制到 DeepL 网页版手动润色。
