VSCode插件界面不会自动汉化,必须同时满足语言包已安装、locale.json正确配置({"locale":"zh-cn"})、插件自身支持中文三者;插件是否显示中文取决于其是否内置package.nls.zh-cn.json并调用vscode.env.language,否则仍为英文。

VSCode 插件界面不会自动随主界面汉化,必须确保语言包已安装、locale.json 正确配置且插件自身支持中文——三者缺一不可,否则你看到的仍是英文菜单、提示或设置项。
为什么装了中文语言包,插件还是英文?
插件界面语言取决于两个独立条件:VS Code 主进程读取的 locale 值,以及插件是否内置对应语言的翻译资源。很多插件(如 Prettier、ESLint)只提供英文字符串,即使 locale 是 zh-cn,它们也显示英文;而部分插件(如 GitLens、Settings Sync)会主动读取 locale 并加载中文翻译。
- 不是所有插件都做了多语言适配,官方语言包不“翻译插件”,只提供 VS Code 自身 UI 的翻译
- 插件作者需显式调用
vscode.env.language并加载对应package.nls.zh-cn.json文件,否则 fallback 为英文 - 某些插件(如 Chinese Menu)是专门补全插件界面汉化的第三方方案,但属于非官方、维护不稳定
如何验证某个插件是否支持中文
打开插件的扩展详情页(左侧扩展图标 → 找到该插件 → 点击齿轮 → Extension Settings),观察设置项标题、描述文字是否为中文;若仍为英文,说明该插件未实现本地化,改 locale 或重装语言包无效。
- 检查插件 GitHub 仓库的
package.nls.zh-cn.json是否存在(常见于开源插件) - 在插件 issue 区搜索
zh-cn或中文,看是否有本地化相关讨论或 PR - 卸载插件后重启 VS Code,再重装,避免缓存导致旧版语言逻辑残留
手动触发插件语言刷新的实操方式
插件通常在激活时读取一次 vscode.env.language,改完 locale.json 后不重启 VS Code,插件可能继续用旧值。最可靠的方式是彻底重启,而非仅重载窗口。
- 关闭所有 VS Code 窗口
- Windows:任务管理器中结束所有
Code.exe进程;macOS:活动监视器中结束Code和Code Helper - Linux:运行
pkill -f "code.*--ms-enable-electron-run-as-node"或直接killall code - 重新启动 VS Code,此时新插件(如刚安装的 GitLens)才会按
zh-cn加载中文资源
Remote-SSH / WSL 下插件界面仍是英文怎么办
远程开发时,插件运行在远程机器上,其语言环境与本地无关。你必须在远程环境里单独配置 locale.json,并确认远程 VS Code Server 已安装语言包。
- 连接远程后,在命令面板执行
Open User Settings (JSON),它打开的是远程路径下的settings.json,不是locale.json - 手动创建或编辑远程的
~/.vscode-server/data/Machine/<hash>/locale.json</hash>,内容严格为{"locale":"zh-cn"} - 远程终端中运行
code --install-extension ms-ceintl.vscode-language-pack-zh-hans安装语言包(需网络通畅) - 重启远程 VS Code Server:断开 SSH 连接,再重新连接,不要点 “Reopen in Remote”
真正卡住的往往不是“怎么设”,而是没意识到插件语言和主界面语言是两套机制;很多用户反复改 settings.json 里的 locale,却忘了插件根本不读这个字段——它只认 locale.json,且只在启动时读一次。


















