vscode插件界面不显示中文,根本原因是locale未生效;需确认设置页、状态栏、命令面板是否已中文,若否则须执行configure display language并重启,或手动创建正确格式的locale.json文件。

VSCode插件界面不显示中文?先确认 locale 是否生效
插件市场(Extensions)本身是 VS Code UI 的一部分,它的语言完全依赖 locale 配置,和插件自身是否“带中文”无关。常见现象是:装了 Chinese (Simplified) Language Pack for Visual Studio Code,但打开扩展面板仍看到 “Install”, “Disable”, “Search Extensions” 等英文——这说明 locale 没生效,不是插件问题。
验证方式很简单:按 Ctrl+, 打开设置页,看左侧导航栏是否为“用户”“工作区”“扩展”等中文。如果不是,别折腾插件列表,直接回退到 locale 设置环节。
- 右下角状态栏显示
en→ 一定没生效 - 命令面板(
Ctrl+Shift+P)上方提示是英文 → 同样未生效 - 只改了
settings.json里的"locale": "zh-cn"→ 无效,VS Code 完全忽略该字段
Configure Display Language 命令为什么总点不对?
这个命令的名称和行为容易被误解。它不叫 Change Language 或 Configure Language,必须输入完整且准确的 Configure Display Language。输错一个字母,匹配到的可能是其他无关命令。
选中命令后弹出的列表里,要点击的是值为 zh-cn 的那一行,不是文字描述为“简体中文”的选项(那个只是辅助说明,不是可选值)。部分用户误点文字项,结果没有任何反应,其实是因为没真正触发配置写入。
- Windows/macOS/Linux 下快捷键统一为
Ctrl+Shift+P(macOS 是Cmd+Shift+P) - 输入时建议逐字敲,避免模糊搜索匹配到
Configure Default Language等干扰项 - 执行后必须点
Restart,不是Reload Window;后者不重载语言环境
手动写 locale.json 是最稳的兜底方案
当命令面板卡死、列表无 zh-cn、或反复切换失败时,直接编辑 locale.json 是最快路径。这不是“高级操作”,而是绕过 UI 层的确定性手段。
文件路径和内容格式极其严格:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json - 文件内容只能是合法 JSON,且仅含一行:
{"locale": "zh-cn"}(注意双引号、小写、短横线、英文逗号) - 不能放在
settings.json里,也不能混在其他配置中
改完后务必从任务管理器(Windows)或活动监视器(macOS)杀掉所有残留的 Code.exe 或 Electron 进程,再双击图标重开——否则新窗口可能继承旧进程的语言上下文。
插件详情页汉化不全?这是正常现象
插件作者自己写的 README、截图、更新日志等内容,VS Code 不翻译。你看到的“Description”“Changelog”“Screenshots”这些标题是 VS Code 自身 UI,会随 locale 变中文;但插件页面中间大块区域的文字,取决于插件发布者是否提供了多语言支持。
比如 Prettier 官方只维护英文文档,GitLens 部分版本有简体中文翻译,但不是强制要求。所以不要因为插件详情页某段英文就怀疑汉化失败。
- 插件安装按钮(Install)、启用开关(Enable)、卸载链接(Uninstall)这些控件文字,100% 会中文
- 插件内嵌的设置项(如
eslint.enable的描述)也由 VS Code 翻译,前提是 locale 生效 - 想让插件文档也中文?得看作者是否提交了
package.nls.zh-cn.json文件,用户无法干预
最常被忽略的一点:Remote-SSH / WSL / Dev Containers 场景下,语言包必须在远程环境中也安装一次,本地装了没用。菜单变中文不代表插件页能全翻,得看哪儿的代码在渲染那块内容。











