VSCode注释翻译需插件实现，推荐Comment Translate；悬停失效需检查hover启用、光标位置及文件语言模式；translateMode建议append模式保障协作安全；翻译问题根源在后端服务配置，优先用DeepL并确保代理正确。
VSCode 本身不支持自动翻译代码注释，所谓“自动”实际是“触发后自动执行”，必须靠插件实现；目前稳定可用、专注注释场景的只有 Comment Translate，Code Translate 更泛用但容易误翻非注释内容。
为什么悬停没反应？检查这三处硬性条件
悬停翻译失效不是插件坏了，而是基础识别链断了：
-
commentTranslate.hover.enabled必须设为true（默认是true，但重装或同步设置后可能被覆盖） - 光标必须严格落在注释语法内：比如
//后有空格再写文字，光标得在空格之后；/* */内部不能紧贴*或/—— 停在/* init的i上可以，停在/或第一个*上就静默忽略 - 当前文件语言模式必须正确：右下角显示
JavaScript、Python等，不能是Plain Text；否则插件根本不会扫描该文件
Comment Translate 的 translateMode 怎么选？
这个配置决定翻译后怎么落回代码里，直接影响协作安全性和可维护性：
-
append（推荐）：在原文后加括号译文，例如// init config → // init config (初始化配置)。git blame、搜索、diff 全部不受影响，新人看中文，老员工仍可基于英文定位逻辑 -
replace：直接覆盖原文，适合本地学习或一次性清理，但会污染 git 历史，且一旦译错难追溯 -
hover：只悬停显示，不写入代码——这是最安全的阅读模式，但无法用于文档沉淀或团队共享
多数团队上线前会统一设为 append，避免翻译引入语义偏差。
翻译结果乱码/超时/报错 ERR_CONNECTION_REFUSED？后端才是关键
插件只是调度器，真正干活的是你配的翻译服务。免费接口（如 Google 公共 API）现在极不稳定：
- 优先换
deepl引擎：注册获取免费 key，填进commentTranslate.source，准确率和响应速度明显提升 - 公司网络若屏蔽境外服务，必须在 VSCode 设置中开启
http.proxySupport，并确保系统代理已配置生效 - 禁用其他翻译插件（如
Live Translate），它们常劫持右键菜单或监听相同快捷键，导致Comment Translate的命令被吞掉却无任何提示
多行注释翻译不连贯？启用合并逻辑
连续几行 // 注释（比如函数上方的参数说明）如果逐行翻译，语义容易割裂。开启 commentTranslate.multilineMerge 后，插件会把相邻的注释块合并成一段再送翻译：
{
"commentTranslate.multilineMerge": true
}这个选项对 JSDoc、Python docstring 等结构化注释特别有用，但要注意：它只合并视觉上连续、中间无空行的注释；一旦隔了空行，就视为两个独立段落。
真正卡住人的从来不是“能不能翻”，而是“翻完敢不敢信”。译文是否保留术语一致性、是否理解上下文中的技术指代——这些都依赖后端引擎能力，而非插件本身。所以别花时间调 UI，先搞定 source 和 proxy 配置。
