vs code 界面变中文需三步:安装官方语言包(ms-ceintl.vscode-language-pack-zh-hans)、执行 configure display language 命令并选 zh-cn、彻底退出所有进程后重启;离线安装用 code --install-extension,手动配置 locale.json 须为 {"locale":"zh-cn"} 且 utf-8 编码。

VS Code 界面变中文,不是装个“汉化插件”就完事——必须装对包、设对值、杀干净进程,三者缺一不可。装错第三方插件、写错 zh-cn、只点 Reload Window,这三类操作占了 90% 的失败案例。
怎么确认装的是 Microsoft 官方中文语言包
在扩展面板(Ctrl+Shift+X)搜 Chinese (Simplified) Language Pack for Visual Studio Code,只认发布者是 Microsoft、ID 是 ms-ceintl.vscode-language-pack-zh-hans 的那个。名字带“汉化”“中文支持”“VSCode Chinese”的第三方插件一律不碰——它们不更新、不兼容新版,有些还会覆盖 locale.json 导致命令面板空白。
- 装完右下角会弹 Restart Now 提示;没弹,基本是安装失败或 VS Code 版本低于 1.13(需先升级)
- 网络受限时可离线安装:
code --install-extension vscode-language-pack-zh-hans.vsix - 装错插件的典型现象:
Configure Display Language命令在命令面板里根本搜不到
Configure Display Language 命令执行后仍显示英文
这个命令才是激活中文的开关,不是“装完即用”。它本质是生成或修正 locale.json 文件,但只写配置、不刷新 UI。很多人点了 zh-cn 却没点提示里的 Restart,或误点 Developer: Reload Window——后者只会重载插件,不加载语言资源。
- 命令名必须输全:
Configure Display Language(注意大小写、空格,不能缩写或换词) - 下拉列表里严格选
zh-cn(不是zh、zh_CN、Chinese) - 点 Restart 后,务必确认所有
Code.exe(Windows)、Electron(macOS)、code(Linux)进程已退出,否则新窗口复用旧 locale
手动编辑 locale.json 强制生效
当命令面板打不开、UI 卡死、或批量部署时,直接改 locale.json 是最稳的兜底方案。VS Code 1.70+ 已彻底弃用 settings.json 中的 "locale": "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、无逗号结尾、双引号必须是英文符号) - 别用记事本或 Sublime 编辑——保存时右下角状态栏必须显示 UTF-8,不是 GBK 或 UTF-8 with BOM
为什么部分菜单/插件还是英文
这不是设置失败,是设计限制。VS Code 本体界面(顶部菜单、命令面板、设置页)能汉化,但以下模块不由 locale.json 控制:
- 终端(Terminal)里的命令提示符、错误信息(如
command not found),由系统 shell 决定 - 调试控制台(Debug Console)输出的日志、断点信息,取决于 Node.js / Python 等运行时环境
- GitLens、Prettier 等插件的右键菜单、侧边栏标题、弹窗文案,需插件自身提供翻译(官方语言包不覆盖)
- 状态栏里的
Ready、Processing…等少量字符串未被完全本地化,属正常现象
真正容易被忽略的,是后台残留进程——哪怕你点了 Restart Now,只要任务管理器里还有 Code.exe,新窗口就继承旧状态,locale.json 根本不加载。











