vs code 界面仍为英文的主因是未执行 configure display language 命令;该命令唯一能正确写入 locale.json 并触发语言切换,需通过命令面板输入全名、选择 zh-cn 后重启。

Configure Display Language 命令没运行过
装了 Chinese (Simplified) Language Pack for Visual Studio Code 但界面还是英文,90% 是因为跳过了这一步:插件只放翻译资源,不自动告诉 VS Code “该用中文”。Configure Display Language 是唯一能正确写入 locale.json 并触发语言切换的入口。
常见错误包括:
- 只点「Install」就以为完事了
- 在设置里搜“language”误改了
editor.language(那是控制代码高亮语言的) - 用
Developer: Reload Window替代重启——它不重载语言环境,右下角仍显示en
正确做法:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入完整命令名 Configure Display Language,回车后从列表中明确点击 zh-cn(不是“简体中文”文字项,也不是 zh 或 zh-TW),然后点提示框里的 Restart 按钮。
locale.json 文件内容或路径不对
VS Code 只读取用户级 locale.json,且只认纯 JSON 格式。手动生成、写错位置、格式出错,都会静默回退英文。
必须满足以下全部条件:
- 文件路径严格匹配:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容只能是合法 JSON,仅含一行:
{"locale": "zh-cn"}(注意双引号、小写、短横线) - 不能有注释、不能多字段、不能漏逗号、不能写成
zh_CN或zh-hans或Chinese - 若文件已存在但被其他工具覆盖(如企业策略组、多版本管理器),需手动清空为仅保留该键值对
检查方式:直接打开对应路径,确认文件存在且内容无误;右下角状态栏显示 en 即说明未生效。
终端和调试控制台仍是英文
菜单、设置页是中文,但集成终端(Ctrl+`)或调试控制台(Debug Console)仍显示英文——这不是汉化失败,而是设计如此。终端和调试控制台属于 Electron 独立子进程,不继承主窗口的 locale 设置。
它们的语言由以下因素决定:
- 系统环境变量(如
LANG、LC_ALL) - 启动时传入的
--locale=zh-cn参数(需手动加) - 终端自身 locale 配置(如 Windows 的
chcp 65001)
VS Code 主程序的汉化配置对这部分完全无效,不要试图通过改 locale.json 解决。
语言包版本或缓存导致加载失败
v1.89+ 版本启用 Ozone 渲染后,对语言包版本有硬性要求:必须 ≥ 1.89.2026052801。旧版会被静默忽略,Configure Display Language 列表里甚至不显示 zh-cn 选项。
验证与修复方法:
- 去扩展页确认
ms-ceintl.vscode-language-pack-zh-hans是否启用且版本号合规 - 若版本过低,卸载后重装;重装失败则手动删掉
~/.vscode/extensions/ms-ceintl.vscode-language-pack-zh-hans-*全部文件夹 - 清除缓存:
%APPDATA%\Code\Cache(Windows)或~/.config/Code/Cache(Linux/macOS) - 打开输出面板(
Ctrl+Shift+U)→ 选Log (Window)→ 搜localization或zh-cn,看是否出现Loaded locale zh-cn from …
最易被忽略的是:插件启用状态 ≠ 语言资源加载成功。即使扩展管理器显示“已安装”,关键文件 package.nls.zh-cn.json 缺失也会导致部分 UI 保持英文。











