VS Code 安装中文语言包后界面仍为英文,主因是 locale.json 文件未正确配置或系统区域设置覆盖;需手动创建/修改该文件为 {"locale": "zh-CN"},并完全重启 VS Code。

VS Code 安装中文语言包后界面仍是英文,大概率不是插件没装上,而是系统语言环境和 VS Code 的 locale 配置没对齐——它压根没“看到”你装了中文包,或者看到了但被更高优先级的设置覆盖了。
检查 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"}(注意双引号、冒号后空格、大小写)。如果文件不存在,手动创建;如果存在但值是 "en" 或为空,直接改掉并保存。改完必须完全退出 VS Code(包括托盘进程),再重新启动。
确认操作系统区域设置不强制覆盖 locale
VS Code 启动时会读取系统区域设置,若系统语言是英文且未显式配置 locale.json,它会默认用英文界面,哪怕中文包已安装。这不是 bug,是设计行为。
验证方式:
- Windows:进「设置 > 时间和语言 > 语言 > Windows 显示语言」,确认是否为「中文(简体,中国)」
- macOS:「系统设置 > 语言与地区 > 首选语言」,拖拽「简体中文」到顶部
- Linux:终端执行
locale,检查LANG是否含zh_CN
改完系统语言后,仍需重启 VS Code,且建议同步确保 locale.json 存在且值为 "zh-CN",避免依赖系统 fallback。
运行 Configure Display Language 命令失败?说明底层配置异常
这个命令本质就是打开并编辑 locale.json。如果命令面板里搜不到、点开空白、或执行后无反应,通常意味着:
- 中文语言包根本没装成功(扩展列表里找不到
ms-ceintl.vscode-language-pack-zh-hans) - VS Code 版本太旧(低于 1.70),不兼容新版语言包格式
-
locale.json所在目录权限异常(尤其 macOS/Linux 下误用sudo启动过)
此时别硬试命令,直接手动编辑 locale.json 更可靠。顺便检查扩展面板中是否真有那个 Microsoft 官方包——别点错名字带“Chinese Language Pack”但发布者不是 Microsoft 的山寨包。
缓存残留导致翻译文件加载失败
VS Code 会缓存 UI 资源,有时旧缓存会卡住新语言包的加载逻辑,表现为:明明 locale.json 是 "zh-CN",也确认插件已启用,但菜单栏、设置页等仍显示英文。
清除缓存路径(关闭 VS Code 后操作):
- Windows:
del /s /q "%APPDATA%\Code\Cache" - macOS:
rm -rf ~/Library/Caches/com.microsoft.VSCode* - Linux:
rm -rf ~/.cache/Code
注意:这不是删 extensions 目录,那是插件本身;缓存目录是独立的,专存运行时资源。清完再启动,首次加载稍慢,但语言应立即生效。
真正卡住的人,往往反复重装插件却忽略 locale.json 是否真实存在、内容是否合法、系统语言是否在后台悄悄覆盖。VS Code 的语言机制很干净,但也很“固执”——它只相信那个 JSON 文件里的字符串,别的都是干扰项。


















