VSCode插件管理界面仍为英文的根本原因是locale.json未正确配置,而非语言包未安装;该文件是VSCode唯一认可的语言开关,决定整个UI语言资源加载路径,必须设为{"locale":"zh-cn"}并重启生效。

VSCode插件管理界面为什么还是英文?
根本原因不是插件没装,而是locale没生效。VSCode 的「扩展」面板(Extensions)属于核心 UI,它的语言完全由 locale.json 控制,和 settings.json 里的 "locale" 字段无关——后者只影响部分设置项,不接管菜单、命令面板、扩展页标题等主干界面。
常见错误现象包括:
- 装了
Chinese (Simplified) Language Pack for Visual Studio Code,但点击左侧「扩展」图标后,顶部仍是「Extensions」、「Search Extensions」、「Installed」、「Recommended」等英文标签 - 按
Ctrl+Shift+P输入Configure Display Language后选了zh-cn,重启后「设置」页面变成中文,但「扩展」页仍为英文 - 手动在
settings.json里加了"locale": "zh-cn",结果无效
必须改 locale.json 才能汉化插件管理页
locale.json 是 VSCode 唯一认的“语言开关”,它决定整个 UI 的语言资源加载路径。插件管理页的翻译就藏在这个包里,但只有当 locale 正确指向 zh-cn 时才会被加载。
操作步骤(以 Windows 为例):
- 彻底关闭所有 VSCode 窗口(包括托盘进程)
- 用记事本打开
%APPDATA%\Code\User\locale.json - 文件内容只能是这一行:
{"locale":"zh-cn"}(注意:双引号、冒号、逗号全为英文符号,不能有空格或注释) - 保存后重新启动 VSCode
macOS 和 Linux 路径分别为:
- macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
Remote-SSH / WSL 场景下插件管理页仍是英文?
这是最常被忽略的坑:你本地装了中文语言包、也配好了 locale.json,但连接 Remote-SSH 或 WSL 后,插件管理页又变英文了——因为远程环境没有语言包。
解决办法不是在本地配,而是在远程端安装语言包:
- 连接到远程环境后,打开扩展面板(
Ctrl+Shift+X) - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code - 确保在「Remote」标签页下点击 Install(不是「Local」)
- 再执行
Configure Display Language→zh-cn→ Restart Remote Window
如果远程端没显示「Remote」标签页,说明你还没启用 Remote 插件(如 Remote - SSH),或者当前窗口未处于远程会话中。
插件列表里的「Install」按钮显示为「安装」但详情页仍是英文?
这说明语言包已生效,但部分第三方插件自身未提供中文描述。VSCode 只能翻译它自己的 UI(菜单、按钮、状态栏),而插件详情页的「Description」「Changelog」「Readme」等内容由插件作者提供,是否汉化取决于他们是否提交了对应语言的 package.nls.zh-cn.json 文件。
比如 ESLint、Prettier 等主流插件已内置简体中文支持,点进去就是中文;但很多小众插件只写了英文文案,VSCode 就只能显示原文。
这类情况无法通过配置解决,只能等待插件作者更新,或直接去 GitHub 提 issue 请求添加中文支持。


















