中文注释插件与界面汉化插件功能不同：前者如caiyun translator专译代码注释，后者如language pack仅汉化ui；caiyun需填api密钥、禁用自动语言检测并设en→zh，chinese-comment则用于自动生成中文文档注释。
中文注释插件 ≠ 界面汉化插件
很多人装完 Chinese (Simplified) Language Pack for Visual Studio Code 就以为能翻译代码注释了，其实它只改菜单和设置项，对 // TODO: 实现登录逻辑 或 /** @param {string} name 用户名 */ 完全无感。真正处理注释的得是另一类插件，比如 Caiyun Translator 或 Chinese-comment，它们干的是“语义级翻译”，不是 UI 层切换。
常见错误现象：右键选中注释 → 没有“翻译”菜单；按 Ctrl+Alt+T 没反应；命令面板搜不到 Translate 命令——大概率是装错了插件类型，或架构不匹配。
Caiyun Translator 是目前最稳的代码注释翻译方案
它专为开发者设计，能识别 JS/TS/Python/Java 等主流语言的注释结构，自动跳过占位符（如 %s、{id}）、保留变量名和函数名不译，避免把 const userId = getID() 里的 userId 错译成“用户ID”。
安装与配置要点：
- 确认 VS Code 架构：命令面板输入
Developer: Show Running Extensions，看插件是否在列表且状态为Active；若没出现，去插件市场页面点Versions，检查是否有darwin-arm64（M1/M2/M3 Mac）或win-arm64（骁龙 Windows）包 - 必须填
caiyun api key：官网注册即得免费额度，不填插件不会激活 - 快捷键默认为
Ctrl+Alt+T（Win/Linux）或Cmd+Alt+T（Mac），划选注释后直接触发 - 遇到
翻译失败:context too long：说明选中注释超 500 字，手动缩小范围或拆成多段再译
别碰 detect source language 自动检测
很多翻译插件默认开启源语言自动识别，这对纯英文注释还行，但遇到混合写法就翻车：// 初始化 config 对象 可能被误判为中文源语言，导致乱码输出；const token = localStorage.getItem('auth_token') 中的 token 又可能被当成英文单词译成“令牌”。
正确做法是关掉自动检测，在插件设置里显式指定：
-
translate.defaultSourceLanguage设为en -
translate.defaultTargetLanguage设为zh（注意不是zh-cn，后者某些插件会拒收并自动清空配置） - 改完不用重启，但得关掉所有已打开的翻译弹窗再重试，否则缓存旧设置
Chinese-comment 插件适合自动生成中文文档
它不翻译已有注释，而是帮你“写”注释：光标停在函数名上，按快捷键就能生成带中文说明的 JSDoc 或 Python docstring，比如把 function fetchUser(id) { ... } 补成：
/**
* 根据用户 ID 获取用户信息
* @param {number} id - 用户唯一标识
* @returns {Promise<object>} 用户数据对象
*/</object>
适用场景有限，但对写 SDK、内部工具库或怕以后看不懂自己代码的人很实用。注意它不支持翻译已有注释，也和 Caiyun Translator 不冲突，可以共存。
容易被忽略的一点：这类插件依赖语言服务器识别函数签名，如果项目没配好 jsconfig.json 或 tsconfig.json，生成的注释可能参数缺失或类型不准。
