必须执行configure display language命令并选zh-cn后重启vs code,仅安装chinese (simplified) language pack插件无效;locale.json文件需由该命令自动生成,内容严格为{"locale":"zh-cn"},路径须在用户级目录,且不可被工作区或远程配置覆盖。

Configure Display Language 命令没执行过
装了 Chinese (Simplified) Language Pack 却还是英文界面,八成是跳过了这一步:插件只提供翻译文件,不自动激活。VS Code 不会读取“已安装”状态来切换语言,它只认 locale.json 里的值,而这个文件只能由 Configure Display Language 命令写入。
操作路径必须严格:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入完整命令名:
Configure Display Language(别输错、别选“Change Language”之类近似项) - 在下拉列表中明确选
zh-cn(不是zh、zh-TW或模糊匹配) - 弹出提示后,点 Restart 按钮——仅重载窗口(
Developer: Reload Window)无效
locale.json 文件被覆盖或内容错误
VS Code 启动时优先读取 locale.json,哪怕你刚在命令面板里选了中文,如果这个文件被其他操作改过,照样回退英文。
检查路径:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容必须严格为:{"locale":"zh-cn"}(注意双引号、冒号后无空格、小写 zh-cn)。任何偏差——比如多一个逗号、空格、大写 ZH-CN,或文件为空/权限只读——都会导致失效。
别手动生成或复制粘贴这个文件。它必须由 VS Code 自己写入,否则可能被忽略。
工作区或远程环境覆盖了语言设置
VS Code 的语言配置有三层优先级:远程实例 > 工作区 > 用户级。你本地设好了,但一打开某个项目或连上 Dev Container,就又变英文,大概率是这些地方偷偷写了冲突配置。
排查重点:
- 当前工作区根目录下
.vscode/settings.json是否含"locale": "en"或类似字段 - 远程开发时,远程端的
locale.json是独立的,需在远程会话里重新运行Configure Display Language - 企业环境中,GPO 策略或 IT 管理工具可能强制锁定
locale,此时本地操作无效
临时验证方法:关闭当前文件夹(File > Close Folder),再执行命令看是否生效。
插件资源损坏或缓存残留
扩展面板显示“已安装”,不代表翻译文件真的加载成功。网络中断、杀毒软件拦截、WSL 权限异常都可能导致 package.nls.zh-cn.json 缺失。
查日志确认真实状态:
- 按
Ctrl+Shift+U打开输出面板 → 选择Log (Window) - 搜索
zh-cn或localization,正常应看到Loaded locale zh-cn from ... - 若出现
Failed to load localization或路径指向空目录,说明资源损坏
修复建议:
- 卸载重装语言包(先禁用再卸载,避免残留)
- 重装前清缓存:
Ctrl+Shift+P→Developer: Toggle Developer Tools→ Console 里执行location.reload() - Windows 上尤其要注意托盘进程是否彻底退出,否则新配置不生效
最易被忽略的是:语言切换和插件启用是两套机制。哪怕你禁用了所有插件,只要没跑过 Configure Display Language 并点 Restart,中文就不会出现——这不是 bug,是设计如此。











