安装中文语言包后界面仍为英文的最常见原因是未执行Configure Display Language命令;该插件不自动激活,必须通过命令面板严格选择zh-cn并重启VS Code,且需确保locale.json路径正确、格式合法、未被覆盖,并彻底终止所有进程。

Configure Display Language 命令没执行,装插件等于白装
安装 Chinese (Simplified) Language Pack for Visual Studio Code 后界面仍是英文,最常见原因就是跳过了 Configure Display Language 这一步。该插件只提供翻译资源,不自动激活——它不会写入 locale.json,也不修改任何配置项。
必须手动触发:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并执行
Configure Display Language - 在下拉列表中**严格选择
zh-cn**(不是zh、zh-hans或Chinese) - 弹出提示后,点
Restart—— 仅关闭窗口再手动打开不算重启,后台进程(如Code Helper)未退出会导致配置不加载
locale.json 路径错、格式错、被覆盖
locale.json 是 VS Code 唯一认的显示语言开关文件,其他地方改的 "locale" 都无效(比如写进 settings.json 完全不起作用)。
常见问题:
-
路径错误:Windows 是
%APPDATA%\Code\User\locale.json,macOS 是~/Library/Application Support/Code/User/locale.json,Linux 是~/.config/Code/User/locale.json;便携版可能写到可执行目录下,导致用户目录里改了也没用 -
JSON 格式非法:必须是合法 JSON,例如
{"locale": "zh-cn"}—— 双引号不能用中文引号,冒号后要有空格,值必须小写且带连字符 -
被工作区或远程设置覆盖:如果当前打开了某个文件夹,且该文件夹下有
.vscode/locale.json,它的优先级高于用户级;临时关闭文件夹(File > Close Folder)再执行Configure Display Language可绕过干扰
重启方式不对,或系统环境变量劫持
VS Code 只在启动时读取 locale.json,运行中修改文件完全无效。但“重启”不是指关标签页或重载窗口,而是彻底终止所有 VS Code 进程。
容易忽略的干扰源:
- 终端里用
code .启动时,若环境变量VSCODE_LANG或LC_ALL已设为en_US,会硬覆盖 locale 设置 - Snap 版本的 VS Code(常见于 Ubuntu)因沙盒限制,无法加载语言包,需改用官方
.deb或tarball包 - 缓存残留:杀掉所有
Code进程后,删掉~/.config/Code/Cache(Linux/macOS)或%APPDATA%\Code\Cache(Windows)可排除旧资源干扰
离线安装 vsix 包版本不匹配
从官网下载的 ms-ceintl.vscode-language-pack-zh-hans-1.90.2.vsix 无法装进 1.91.0-insider,报 not compatible with Code 就是这个原因。
修复步骤:
- 用
unzip -l your-plugin.vsix确认根目录含extension/package.json - 解压后修改
package.json中的"engines": {"vscode": "^1.85.0"}字段,改成你本地code --version输出的主版本号(如1.91.0→ 改成"^1.91.0") - 重新打包必须用
zip命令或 7-Zip;Windows 资源管理器双击解压再拖回压缩,会破坏 ZIP 结构,导致安装静默失败
真正卡住人的地方,往往不是不会装插件,而是配置写对了、插件也装上了,却因为进程没杀干净、路径没找对、或者版本号差了一位小数点,让整个流程停在最后一步。


















