vscode翻译插件需匹配arm架构、关闭自动源语言检测并手动指定en→zh，推荐caiyun translator处理代码注释。
VSCode 里装翻译插件不是“装了就能用”，关键在选对插件、配对引擎、避开 ARM 架构兼容性雷区。直接装“Translate”或“彩云小译”大概率翻车，尤其 M1/M2/M3 Mac 或高通骁龙 Windows 笔记本用户。
确认你的 VSCode 是 arm64 还是 x64 架构
插件市场里很多翻译插件（比如旧版 yzane.translate）只打包了 x64 架构二进制，装到 darwin-arm64 或 win-arm64 版 VSCode 上会静默失效——命令面板搜不到 Translate，右键也没菜单，连报错都不给。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Developer: Show Running Extensions，看目标插件是否在列表且状态为Active - 如果没出现，去插件市场页面右下角点
Versions，检查最新发布包里有没有darwin-arm64（Mac）或win-arm64（Windows on ARM）标签 - 没有就别硬装；临时替代：用浏览器划词 +
Alt+Shift+T转发到 VSCode（需提前配好externalTerminal）
选插件：代码注释翻译优先用 Caiyun Translator
Caiyun Translator（彩云小译）对代码上下文理解比通用翻译插件强，能自动跳过字符串里的占位符（如 %s、{name}），保留变量名和函数名不译，适合读开源项目注释。
- 安装后必须填
caiyun api key，免费额度够日常用（官网注册即得） - 默认快捷键
Ctrl+Alt+T（Win/Linux）或Cmd+Alt+T（Mac），划选注释后直接触发 - 它不翻译整个文件，但支持连续按快捷键跳着译多段注释——比
Translate插件的批量模式更可控 - 若遇到「翻译失败：context too long」，说明注释块超 500 字；手动缩小选区，或把长段落拆成两句再译
配置 locale 和 translate.defaultTargetLanguage
VSCode 界面语言（zh-cn）和翻译目标语言（比如 zh）是两回事，设混会导致右键菜单消失或翻译结果乱码。
- 界面汉化用
MS-CEINTL.vscode-language-pack-zh-hans，装完重启，settings.json 里加"locale": "zh-cn"即可 - 翻译插件的目标语言单独配：打开设置（
Ctrl+,），搜translate.defaultTargetLanguage，设为zh（不是zh-cn） - 某些插件（如
rokoroku.vscode-japanese-translator）会把zh-cn当非法值直接拒掉配置，保存后自动回退为空 - 改完配置不用重启，但得关掉所有翻译弹窗再重试，否则缓存旧设置
翻译注释时变量名被误译？关掉「自动检测源语言」
插件默认开启 detect source language，遇到 const userId = ... 这种混合写法，可能把 userId 当英文单词译成「用户ID」，破坏语义。
- 在插件设置里关掉
translate.detectSourceLanguage - 手动指定源语言为
en，目标语言为zh，强制走直译通道 - 对含中文的 JS/TS 文件（比如
// 用户点击按钮时触发），先全选注释块再译，避免插件把中文当源语言二次处理 - 如果仍出错，检查当前文件关联语言模式：右下角语言标识要是
javascript，不是plaintext——否则插件不加载语法感知逻辑
真正卡住人的从来不是“怎么装”，而是装完发现右键没选项、快捷键没反应、或者译出来全是“用户识别号”这种鬼话。盯住架构标签、关掉自动检测、手动锁死源语言，这三步做完，90% 的注释翻译问题就解了。
