vscode 必须安装官方 microsoft 发布的 chinese (simplified) language pack for visual studio code,再通过 configure display language 命令将 locale.json 中的 "locale" 改为 "zh-cn" 并彻底重启进程,缺一不可。

VSCode 不会因为装了语言包就自动变中文,必须安装官方 Chinese (Simplified) Language Pack for Visual Studio Code,再手动执行 Configure Display Language 命令将 locale 设为 zh-cn,并彻底重启进程——跳过任意一步,界面都会残留英文。
怎么找到并安装正确的 Language Pack
搜“中文插件”“汉化包”大概率装错,VS Code 官方只认一个扩展:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索框里严格粘贴全名:
Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写) - 认准蓝白 VS Code logo + 中文“中”字图标 + Microsoft 签名,别点
Chinese Language Pack或任何带“Pro”“Ultimate”的仿冒包 - 点击
Install后,不要点弹窗里的 “Reload” 按钮——它只重载扩展逻辑,不触发语言切换
Configure Display Language 命令为什么必须手动执行
语言包只是把翻译资源放进本地目录,就像买了本字典却不翻开。VS Code 默认仍用 en,必须显式告诉它“我要中文”,而这个开关就是 Configure Display Language 命令。
- 按
Ctrl+Shift+P打开命令面板,输入并选择:Configure Display Language - 在弹出的 JSON 文件中,把
"locale": "en"改成"locale": "zh-cn"(注意:小写、短横线、双引号包裹) - 不能写成
zh_CN、zh-hans、Chinese或zh——这些全部无效 - 保存后,必须点击提示中的
Restart按钮,或手动关闭所有窗口 + 杀掉后台进程(Windows 查Code.exe,macOS 查Electron)再重开
改了 locale 还是英文?重点排查这几个地方
最常被忽略的是进程没关干净,新窗口继承了旧环境;其次是配置文件路径或层级写错。
- 确认改的是
locale.json,不是settings.json:
Windows 路径是%USERPROFILE%\AppData\Roaming\Code\User\locale.json
macOS/Linux 路径是~/.vscode/locale.json - 如果用远程开发(SSH/WSL),语言包和
locale.json都得在远程环境里单独配,本地装了没用 - 某些 Linux 发行版系统语言设为
zh_CN.UTF-8但 VS Code 读不到,这时硬写"locale": "zh-hans"更可靠(部分版本接受该值) - 右下角状态栏会显示当前语言代码(如
en或zh-cn),如果还是en,直接点击它 → 选zh-cn,这是最快速的兜底验证方式
真正生效的关键不在“装了多少”,而在“是否改对了 locale 值 + 是否杀干净了后台进程”。哪怕语言包被误删,只要 locale.json 里写着 "zh-cn",VS Code 启动时仍会尝试加载——所以删包不删配置,有时比重装更快。











