VSCode翻译插件需选对架构、关自动源语言检测并正确配置目标语言；Caiyun Translator最稳，支持跳过占位符；ARM设备须确认插件含darwin-arm64/win-arm64包，界面汉化与翻译语言不可混设。
VSCode 里装翻译插件不是“装了就能译”，关键在选对插件、配对架构、关掉自动源语言检测——否则注释里的 userId 可能被译成「用户ID」，%s 被当成英文单词翻掉，甚至 ARM 架构下插件根本不出现在命令面板里。
确认 VSCode 架构再装插件
旧版翻译插件（比如 yzane.translate）只打包了 x64 二进制，装到 M1/M2/M3 Mac 或高通骁龙 Windows 笔记本上会静默失效：右键没菜单、命令面板搜不到 Translate、连错误都不报。
- 按
Ctrl+Shift+P输入Developer: Show Running Extensions，看插件是否在列表且状态为Active - 去插件市场页面右下角点
Versions，检查最新发布包里有没有darwin-arm64（Mac）或win-arm64（ARM Windows）标签 - 没有就别硬装；临时替代：浏览器划词 +
Alt+Shift+T转发到 VSCode（需提前配好externalTerminal）
Caiyun Translator 处理代码注释最稳
它对上下文理解强，能自动跳过字符串占位符（如 %s、{name}），保留变量名和函数名不译，适合读开源项目注释。
- 安装后必须填
caiyun api key（官网注册即得，免费额度够日常用） - 默认快捷键：
Ctrl+Alt+T（Win/Linux）或Cmd+Alt+T（Mac），划选注释后直接触发 - 遇到
翻译失败:context too long，说明注释块超 500 字；手动缩小选区，或把长段落拆成两句再译
界面汉化和翻译目标语言不能混设
locale 是 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」，破坏语义。
- 在插件设置里找到类似
translatorHelper.detectSourceLanguage或detect source language的开关，手动关掉 - 改为显式指定源语言：
translatorHelper.sourceLanguage设为en，translatorHelper.targetLanguage设为zh - 改完不用重启，但得关掉所有已打开的翻译弹窗再重试，否则缓存旧设置
真正麻烦的不是装不上，而是插件在后台悄悄把 API_KEY、JWT_TOKEN 这类词按字面意思译成「API密钥」「JWT令牌」——这类术语该保留英文，但多数插件没提供白名单机制，只能靠关自动检测 + 手动选区来绕开。
