vs code中文界面需安装官方中文语言包、执行configure display language命令设locale为"zh-cn"并彻底重启;仅装插件或改settings.json无效,因1.70+版本只认locale.json配置。

中文包装了但界面还是英文,90% 是因为没走对配置路径——不是插件没装上,而是 VS Code 根本没“决定”用它。
Configure Display Language 命令没执行或选错值
VS Code 不会自动启用已安装的语言包,Configure Display Language 是唯一能写入生效配置的入口。跳过这步,装十遍也没用。
- 必须用
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板,输入并执行Configure Display Language - 列表里选的是
zh-cn,不是zh、Chinese或zh-hans(后者是包 ID 里的标识,不是运行时 locale 值) - 选完后弹出提示,必须点
Restart,仅关闭再手动打开不算重启——托盘进程(Code Helper)不退出会导致配置未加载
locale.json 文件缺失、格式错误或被覆盖
VS Code 实际只认 locale.json 里的 {"locale": "zh-cn"},其他地方写的 "locale" 都无效,包括 settings.json。
- 文件路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容必须是合法 JSON:双引号、冒号后有空格、值为小写
"zh-cn"(不是"zh_CN"或"zh-Hans") - 如果该文件存在但值是
"en"或为空,说明被工作区设置、远程开发环境或 IT 策略插件覆盖;临时关闭文件夹(File > Close Folder)再执行命令可绕过干扰
离线安装 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 结构,导致安装静默失败
缓存残留或系统区域设置强制覆盖
即使 locale.json 正确、插件也装好了,部分菜单仍英文,大概率是缓存没清干净,或者系统语言设置在底层劫持了启动逻辑。
- 关掉所有 VS Code 进程后,删掉缓存目录:
Windows:del /s /q "%APPDATA%\Code\Cache"
macOS/Linux:rm -rf ~/.cache/Code - Windows 若开了「Beta: Use Unicode UTF-8」且系统显示语言是英文,VS Code 会跳过语言包加载;macOS/Linux 检查终端
locale输出,若LANG=en_US.UTF-8优先级高于 VS Code 配置,也会 fallback 到英文 - 双击桌面快捷方式可能启动旧版实例(尤其企业统一部署的老镜像),务必从开始菜单或应用坞启动,并确认任务管理器/活动监视器中无残留
Code Helper进程
最常被忽略的一点:中文包依赖 VS Code 内置的 vs/nls.js 模块做运行时字符串替换,而这个模块在 VS Code ≤1.75 中默认不启用。如果你用的是内网老旧镜像源部署的版本,装了包也白装——得先升级编辑器本身。











