vscode自带中文语言包仅翻译主界面,不支持插件ui汉化;插件需作者主动集成vscode.l10n api并提供package.nls.json才能实现真正本地化,目前仅eslint等少数插件完整支持。

VSCode 自带语言包是否足够用
VSCode 官方确实提供中文语言包(Chinese (Simplified) Language Pack for Visual Studio Code),但仅翻译界面主菜单、设置项、弹窗提示等静态 UI,不处理插件自带的界面文本。很多插件(如 GitLens、Remote - SSH、Prettier)的按钮、侧边栏标题、状态栏提示仍显示英文,这是正常现象,不是你装错了。
原因很简单:插件作者需主动调用 VSCode 的 vscode.l10n API 并提供对应语言的 package.nls.json 文件,否则 VSCode 无法翻译其 UI。目前只有少数插件(如 ESLint、GitHub Pull Requests and Issues)做了完整本地化支持。
哪些插件能被真正汉化
判断一个插件能否被中文翻译,看它是否在 package.json 中声明了 contributes.localizedLanguageIds 或使用了 vscode.l10n 调用,实际可查的方式更直接:
- 打开插件官方 GitHub 仓库,搜索
package.nls或vscode.l10n - 在插件设置页中搜索
locale或language,部分插件(如Code Spell Checker)允许手动指定 UI 语言 - 安装后观察其侧边栏/视图标题是否随系统语言变化——若不变,基本无本地化
典型已支持中文的插件:ESLint、Live Server、Settings Sync;典型不支持的:Bracket Pair Colorizer(已停更)、Auto Rename Tag(无 nls 文件)、IntelliCode(部分提示仍为英文)。
手动修改插件界面文本的可行性
不推荐直接编辑插件源码汉化。VSCode 插件以 .vsix 形式分发,解压后修改 package.nls.json 或 HTML 模板虽技术上可行,但存在三个硬伤:
- 每次插件自动更新会覆盖所有修改
- 签名校验失败可能导致插件禁用或报错
Extension host terminated unexpectedly - 部分插件(如基于 Webview 的
Markdown Preview Enhanced)文本写死在 JS 里,改 JSON 无效
真有强需求,可尝试用社区维护的汉化补丁项目(如 GitHub 上的 vscode-chinese-patch),但务必确认其最后更新时间——2024 年后多数已失效,且与 VSCode 1.85+ 的 l10n 架构不兼容。
开发者如何让自己的插件支持中文
如果你是插件作者,让 UI 可翻译只需两步,且必须用 VSCode 1.83+ 推荐的新 vscode.l10n 方式:
- 在
package.json的contributes下添加"localizedLanguageIds": ["zh-cn"] - 所有用户可见字符串统一用
vscode.l10n.t("Save file")替代直写"Save file" - 运行
npx @vscode/l10n-dev extract生成package.nls.json,再人工翻译对应字段
旧式 __filename + i18n 目录方式已被弃用,VSCode 1.90 起将完全不加载此类语言资源。
真正卡住大多数人的不是“怎么翻”,而是“谁来翻”——插件生态的本地化依赖作者意愿和维护节奏。与其反复折腾汉化,不如优先选用已明确标注 Supports Chinese 的插件,或直接适应英文 UI,毕竟快捷键、命令面板(Ctrl+Shift+P)和错误信息本身就不依赖翻译。











