悬停翻译依赖插件类型而非设置开关:vscode-comment-translate专译注释,需手动启用hover.enabled及正确配置source/targetLanguage;Translate Dict适合查词;code-translator为混合型。

悬停翻译不是靠“设置开关”,而是选对插件类型
VSCode 本身不提供悬停翻译功能,所有翻译能力都来自第三方插件,但不同插件处理的文本范围和触发逻辑完全不同。装错类型,再调设置也没用。
关键区分三类行为:
-
vscode-comment-translate:只处理注释(//、/* */、docstring),光标停在注释内即触发,不碰代码、字符串或变量名 -
Translate Dict或Quick Translate:面向“查词”,依赖鼠标悬停位置的文本选中范围,适合单个英文单词或短语,对整段注释支持弱 -
code-translator:混合型,支持悬停查词 + 快捷键翻译中文命名,但默认不自动渲染注释,需手动开启codeTranslator.hoverEnabled
如果你的目标是“阅读外文开源项目时看懂注释”,vscode-comment-translate 是目前最稳定的选择;想临时查 res.status(404) 里 status 的意思,用 Translate Dict 更轻量。
vscode-comment-translate 的 hover 行为必须手动启用
这个插件默认不开启悬停翻译,即使安装完也看不到提示——它把控制权交给了配置项,而不是开箱即用。
你需要在 settings.json 中显式开启:
"commentTranslate.hover.enabled": true, "commentTranslate.source": "en", "commentTranslate.targetLanguage": "zh-CN"
常见错误:
- 只设了
hover.enabled,但没配source和targetLanguage,结果悬停无反应(插件无法判断该翻谁) - 把
source错写成en-US或english,实际只认en、zh这类 ISO 639-1 码 - 工作区设置了,但用户全局设置里有同名字段覆盖了它(VSCode 设置优先级:工作区 > 用户 > 默认)
改完不用重启,但得保存文件并重新悬停一次——旧缓存不会自动刷新。
延迟设太低反而没内容,200–400ms 是实测安全区间
很多人以为把 editor.hover.delay 改成 0 就能“秒出翻译”,结果只看到空白框闪一下,或卡住两秒才显示。这不是插件问题,是语言服务器冷启动暴露出来了。
真实情况:
-
editor.hover.delay: 0不等于“立刻显示”,而是立刻发请求,此时 Pylance/Volar 可能还在加载类型库 - 设为
200~400毫秒,刚好避开服务刚唤醒时的抖动,又比默认500更跟手 - 这个 delay 只影响原生 hover 触发时机,
vscode-comment-translate自己的悬停是独立监听的,不受它控制
如果你发现悬停翻译响应慢,先检查插件自己的延迟配置:commentTranslate.hover.delay(部分版本支持),而不是盲目调低全局 editor.hover.delay。
中文注释不翻译?检查是否误开了“沉浸式”或语言识别失效
vscode-comment-translate 默认只翻“被识别为外语”的注释。它靠简单规则判断源语言:比如注释含大量 ASCII 字符、无中文标点、匹配英文停用词(the、and、return 等)——所以纯中文注释不会被触发翻译。
但如果你开启了 commentTranslate.immersiveMode,它会反向工作:把中文注释渲染成双语对照(原文+译文),这时就要求你提前配好 source 为 zh。
容易忽略的点:
- 多行注释开头有空格或制表符,导致插件解析失败,跳过整块注释
- 注释里混了代码片段(如
// @param {string} name - 用户姓名),中间的英文关键词可能干扰语言判定 - 禁用了
editor.quickSuggestions或editor.suggestOnTriggerCharacters,虽不影响 hover,但会让插件内部的 token 分析变弱
最稳妥的验证方式:在空文件里写一行 // init config,保存后悬停——如果这都无反应,基本可断定是配置或插件未激活问题,不是项目结构导致的。


















