VSCode翻译插件需按使用目标选型并精准配置：ARM设备须选适配架构版本，注释翻译需光标落于有效位置且禁用冲突插件，变量名翻译应关闭实时模式并手动触发，乱码问题需强制指定源语言及UTF-8编码。
VSCode 里装翻译插件不是“装上就能用”，关键看你是想读注释、查变量、还是写命名——不同目标对应完全不同的插件和配置，装错一个就卡顿、乱码、甚至干扰编码节奏。
vscode-translator 装不上？先确认你的 CPU 架构
很多用户点安装后图标不出现、快捷键没反应，根本原因不是网络或权限，而是插件不支持 ARM64。Translator 主力版本只打包了 x64 的 Webview 资源，M1/M2/M3 Mac 或 Windows on ARM 设备会静默失败。
- 打开命令面板（
Ctrl+Shift+P），输入Developer: Show Running Extensions，看translator是否在列表且状态为Active - 若没出现，去插件市场页面右下角点
Versions，检查最新版是否有darwin-arm64或win-arm64标签——没有就别硬装 - ARM 用户更稳的选择：
Comment Translate（纯注释）或CodeLLDB（调试时 hover 查变量/错误）
Comment Translate 悬停不显示译文？检查光标位置和语言模式
它只响应真正落在注释内部的光标：停在 // 前一个空格、或紧贴着 ; 后面，都会静默忽略。
- 验证方式：
Ctrl+Shift+P→ 输入Change Language Mode，右下角必须显示javascript、python等真实语言，不能是Plain Text - 配置
commentTranslate.translateMode推荐设为append，例如：// init config object→// init config object (初始化配置对象)，保留原始英文便于git blame和搜索 - 禁用其它翻译插件（如
Live Translate），它们常劫持右键菜单或冲突快捷键，失败还不报错
vscode-translator 翻译变量名像机翻？关掉 translateOnType
默认开启实时翻译，对 userProfileData 这类驼峰名会拆成「用户 轮廓 数据」，完全丢失语义。这不是翻译不准，是上下文识别被关闭了。
- 在
settings.json中设："translator.translateOnType": false，改用手动触发（默认快捷键Ctrl+Alt+T） - 选中完整标识符再触发，比如整段选中
fetchLatestNotificationList，插件才能判断这是函数名 - 加白名单避免干扰：
"translator.ignoreLanguages": ["typescript", "javascript"]，写代码时不弹任何翻译浮层
翻译结果全是乱码或日文？强制指定 contentLanguage 和文件编码
插件默认靠文件顶部的 /** @language zh */ 或 HTML 的 <meta charset="gbk"> 推断源语言，而多数 JS/TS 文件根本没声明，导致误判。
- 读开源库源码时，在设置里加：
"translator.contentLanguage": "en" - 遇到 GBK 编码的老文档（如某些国产 SDK），先用 VSCode 右下角编码切换器转成
UTF-8 with BOM，否则字节流读取错位，译文必然乱码 - 混合注释（如
// TODO: fix login state bug）别依赖自动识别，手动选中英文部分再翻译
最易被忽略的一点：所有翻译插件的准确率都严重依赖你是否关闭了自动检测。像 vscode-bing-translate 默认开 autoDetect，看到 if (x > 0) { } 就调 API 判定“伪代码”，结果返回一堆乱码——这类配置项不手动关，插件越勤快，越坏事。
