VSCode扩展界面不会被汉化,因官方不翻译远程资源;扩展市场页文案来自作者提交内容,需手动多语言支持;可用Caiyun Translator等插件对网页式内容实时翻译,但Webview和终端输出不受影响。

VSCode 扩展程序本身不会被汉化,界面语言设置只影响编辑器主 UI(菜单、设置面板、命令面板等),不控制扩展的描述页、弹窗、侧边栏内容或插件内部文案——这是设计使然,不是配置错误。
为什么扩展说明页还是英文?
扩展市场页面(Extensions 视图)里的插件标题、描述、README、版本更新日志等,全部来自插件作者提交的 package.json 和 GitHub/GitLab 仓库内容。VSCode 不翻译这些远程资源,也不提供本地化映射机制。
- 即使你已正确设置
"locale": "zh-cn"并重启,扩展搜索结果页仍显示英文说明 - 点击某个插件进入详情页后,所有文案(包括“Install”“Disable”按钮文字)也保持原样
- 部分高质量插件(如
ESLint、Prettier)自己提供了多语言 README,但需作者手动维护,VSCode 不参与
用翻译插件实时翻译扩展说明页
既然无法全局汉化,就用翻译插件对网页式内容做即时覆盖。推荐 Caiyun Translator(彩云小译),它支持划词+整块翻译,且能识别 Markdown 结构,避免把代码块当正文误译。
- 安装后默认快捷键是
Ctrl+Alt+T(Win/Linux)或Cmd+Alt+T(Mac) - 在扩展搜索框输入关键词(如
gitlens),等结果加载完,鼠标选中任意一段英文描述,直接触发翻译 - 若整段太长报
context too long,缩小选区,优先译「Description」和「Changelog」两栏 - 注意关闭插件的
detect source language,否则可能把vscode.workspace.getConfiguration()这类 API 名当英文单词乱译
翻译插件对扩展 UI 的作用边界
有些扩展自带面板(如 GitLens 的 Commit Graph、Remote-SSH 的连接列表),它们属于 Webview 渲染,理论上可被翻译插件捕获——但实际效果不稳定:
-
Caiyun Translator能翻 GitLens 右键菜单里的英文项(如 “Copy Commit ID”),但不保证每次生效 -
Google Translate类插件常因 CSP 策略被 Webview 拦截,连右键菜单都不出现 - 调试控制台、终端输出、集成终端中的命令提示(如
npx create-react-app日志)完全不受任何翻译插件影响
真正容易被忽略的是:很多人以为装了翻译插件就能“一键汉化所有”,结果发现扩展页、插件弹窗、甚至某些设置项仍是英文,就开始怀疑 locale 配错了。其实不是配置问题,是 VSCode 从没承诺过翻译扩展内容——这个限制写在官方文档的 Extension Manifest 一节里,但极少有人去看。


















