必须执行Configure Display Language命令并彻底重启进程,因语言包仅提供翻译文件,UI语言由locale.json中"locale": "zh-cn"决定,且需终止所有VS Code后台进程才能生效。

VS Code 安装完中文语言包后界面仍是英文,不是插件没装好,而是漏掉了最关键的一步:必须显式执行 Configure Display Language 命令并彻底重启进程。这一步不可跳过,也不被自动触发。
为什么装完语言包还是英文?
语言包只是“翻译词典”,VS Code 不会自己调用它。安装插件只把翻译文件下载到 ~/.vscode/extensions/,但 UI 语言仍由运行时 locale 决定——而这个值默认是 "en",不会因插件安装自动改写。
-
Configure Display Language是唯一官方支持的激活入口,它会生成或修正用户级locale.json - 点扩展面板右上角的「Install」后弹出的提示里,必须点「Change and Restart」,不能只点「Reload Window」
- 在命令面板中输入关键词时,必须输全称
Configure Display Language,搜zh-cn或language setting都找不到该命令 - 选中列表里的「简体中文」文字项无效,真正生效的是其对应代码标识符
zh-cn(小写、短横线、带英文引号)
手动创建 locale.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"}(无空格、无换行、无 BOM、双引号和冒号都必须是英文符号) - 如果已有
settings.json里写了"locale": "zh-cn",请删掉或注释掉——这个字段从 VS Code 1.70+ 起已完全失效 - 文件名不能是
locale.json.bak或locale.js,VS Code 只认locale.json这个精确名称
重启不彻底 = 白忙活
VS Code 的语言环境绑定在进程实例上。后台残留的 Code.exe(Windows)、Electron(macOS)或 code(Linux)进程会继承旧 locale,导致新窗口仍是英文。
- Windows:打开任务管理器 → 结束所有
Code.exe进程(包括“后台进程”标签页里的) - macOS:活动监视器中搜索
Electron,或终端执行pkill -f "Electron.*Code" - Linux:运行
pkill -f "code.*--no-sandbox" - 验证是否生效:重启后打开命令面板(
Ctrl+Shift+P),看提示文字是否变成“请输入命令或搜索设置”
插件界面还是英文?这不是 bug
GitLens、ESLint、Prettier 等插件的菜单和设置页显示英文,通常不是配置问题,而是它们本身不提供翻译——这些 UI 文字由 VS Code 主体语言决定,但部分插件需单独配置语言项。
- 例如
GitLens支持gitlens.language设置,需在settings.json中手动加:"gitlens.language": "zh-cn" - Copilot Chat、CodeBuddy 等 WebView 插件依赖远程服务返回语言,本地
locale.json对其无效 - 主题类插件若硬编码英文文案,或覆盖了字体渲染逻辑,也可能导致中文显示异常,这类问题无法通过 locale 解决
最常被忽略的其实是进程残留和 locale.json 的格式细节:多一个空格、少一个引号、路径错一级,VS Code 都会静默回退到英文,且不报任何错误。


















