VS Code设置中文界面最有效三步是:安装Microsoft官方中文语言包(ID为ms-ceintl.vscode-language-pack-zh-hans)、执行Configure Display Language命令并选zh-cn、彻底重启所有进程;其他方式在2026年已基本失效或易出错。

VSCode 设置中文界面只有三步有效:装对语言包、执行 Configure Display Language 命令选 zh-cn、彻底重启窗口。其他所有“改 settings.json”“点右下角状态栏切换”“手动写 locale.json 后只重载不退出进程”的操作,2026 年已基本失效或极易出错。
怎么确认装的是 Microsoft 官方中文语言包
在扩展面板(Ctrl+Shift+X)中搜索 Chinese (Simplified) Language Pack for Visual Studio Code,只认发布者是 Microsoft、ID 为 ms-ceintl.vscode-language-pack-zh-hans、图标带蓝勾的那一项。名字含“汉化”“中文支持”“VSCode Chinese”的第三方插件一律跳过——它们不更新、不兼容新版,装了反而会让命令面板空白或报 Cannot read property 'translate' of undefined。
- 安装后右下角必须弹出 Restart Now 提示;没弹,大概率是网络受限或 VS Code 版本低于 1.13(需先升级)
- 搜不到该插件?说明网络受限,可去 GitHub 下载
vscode-language-pack-zh-hans.vsix,再用命令行安装:code --install-extension vscode-language-pack-zh-hans.vsix - 装错插件的典型表现:
Configure Display Language命令在命令面板里根本搜不到
Configure Display Language 命令为什么点了还是英文
这个命令不是“一键生效”,而是生成或修正 locale.json 文件。它只写配置,不刷新 UI。很多人卡在这一步,本质是没完成最后一步:重启。
- 命令名必须输全:
Configure Display Language(注意大小写、空格,不能缩写) - 下拉列表里严格选
zh-cn—— 不是zh、不是zh_CN、也不是Chinese - 看到提示“需要重启窗口以应用更改”,必须点 Restart;点
Developer: Reload Window不会重新读取语言资源 - 点完 Restart 后,务必检查任务管理器(Windows)或活动监视器(macOS)里所有
code.exe/Electron进程是否已退出,否则新窗口复用旧 locale
手动改 locale.json 是最稳的兜底方式
当命令面板打不开、UI 卡死、或批量部署时,直接编辑 locale.json 是唯一可靠路径。VS Code 1.80+ 已彻底弃用 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
- 改完必须彻底关闭 VS Code 所有进程,再重开;仅靠“重载窗口”无效
终端、调试控制台、Git 输出默认仍是英文,这不是失败,是 VS Code 的设计行为。汉化覆盖率约 85%,右键菜单、Remote-SSH 连接列表等区域留白属于正常翻译进度问题,强行折腾系统区域设置或终端编码,反而容易引发乱码。











