VSCode无原生注释自动翻译功能，需依赖插件+外部API且必须手动触发；Comment Translate专注注释不碰代码，仅响应光标在注释内快捷键；Code Translate可译任意选中文本但易误翻标识符；API配置需严格校验有效性与权限。
VSCode 本身不支持自动翻译代码注释，所有“直接翻译”都依赖插件 + 外部翻译 API，且必须手动触发——没有稳定可靠的“边写边翻”方案，强行开启自动模式反而容易误翻变量名、破坏驼峰命名（比如 handleError 被拆成“处理 错误”）。
Comment Translate：专注注释、不碰代码结构
这是目前唯一能真正区分“注释”和“代码”的插件。它只响应光标落在 // 或 /* */ 内部时的快捷键（默认 Ctrl+Shift+T），原地替换注释文本，不改动函数名、参数、字符串字面量。
常见错误现象：Cannot translate: no comment under cursor —— 光标没停在注释行内，或注释语法不标准（比如用 # 写 Python 注释却没启用对应语言支持）。
实操建议：
- 安装后务必打开设置，填入合法的 API Key（Google Cloud Translation API 或 有道智云 ID/Secret）；无 Key 时插件会静默失败
- 多行注释默认逐行翻译，如需合并语义（如 JSDoc 中的
@param描述），勾选设置里的Merge multi-line comments - 不推荐绑定
Ctrl+T—— 它和 VS Code 标签页切换冲突，改用Alt+T更稳妥
Code Translate：灵活但需手动选中
适合查某个陌生 API 的文档字符串、或临时翻译一段英文 TODO，支持右键菜单触发，能翻译任意选中文本（包括注释、字符串、甚至 console.log 里的提示）。
性能影响明显：选中大段含大量驼峰标识符的代码时，它会尝试分词翻译，导致结果失真（getBoundingClientRect → “获取 边界 客户 矩形”）。
实操建议：
- 仅在明确需要翻译纯自然语言片段时使用，避免全选函数体
- 翻译后结果默认显示在弹窗，不自动替换原文；想覆盖原注释得手动粘贴
- 它依赖浏览器环境调用翻译服务，若本地禁用 JavaScript 或网络受限，会直接报
Failed to fetch translation
API 配置踩坑点：Key 有效 ≠ 翻译可用
Google Cloud 的 Cloud Translation API 免费额度虽够个人用，但必须确认三点：项目已启用该 API、API Key 绑定的项目与启用 API 的项目一致、未开启 IP 白名单限制（否则本地开发机请求被拒）。
有道智云则要求实名认证 + 应用创建后“激活服务”，且其免费版对单次请求字符数有限制（通常 200 字以内），长注释会被截断翻译。
实操建议：
- 测试 API 是否生效：在终端执行
curl "https://translation.googleapis.com/language/translate/v2?key=YOUR_KEY" -d "q=test" -d "source=en" -d "target=zh"，看是否返回 JSON 结果 - VS Code 设置里填错 Key 不报错，只会在输出面板（
View → Output → Comment Translate）里打印Invalid API key or quota exceeded - DeepL 插件全是非官方抓包实现，2026 年起多数已失效或频繁 403；别信名字带 “DeepL Official” 的扩展
真正影响体验的不是插件选哪个，而是你是否接受“翻译是辅助动作，不是编辑流程一部分”——每次停顿、光标定位、按键触发，都是必要成本。那些宣称“全自动”“智能上下文”的插件，要么功能残缺，要么在后台偷偷开浏览器进程拖慢编辑器，尤其打开 >5MB 的文件时，Translate: Toggle Translate Mode 一开，CPU 就拉满。
