装中文语言包必须认准 microsoft 官方插件 chinese (simplified) language pack for visual studio code(id:ms-ceintl.vscode-language-pack-zh-hans),安装后需执行 configure display language 命令并选 zh-cn,或手动创建 utf-8 无 bom 的 locale.json 文件写入 {"locale":"zh-cn"}。

装中文语言包必须认准 Microsoft 官方 ID
VSCode 界面汉化只依赖一个插件:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 MS-CEINTL.vscode-language-pack-zh-hans。搜“中文插件”“汉化”“chinese language”等模糊词,大概率装到第三方非官方包,结果命令面板里找不到 Configure Display Language,界面也切不动。
正确做法是:
- 按
Ctrl+Shift+X打开扩展面板 - 搜索框里直接输入完整名称:
Chinese (Simplified) Language Pack for Visual Studio Code - 认准图标是蓝白 VS Logo、作者栏写
Microsoft - 点安装后,右下角弹出提示时必须点
Reload(不是“重新加载窗口”,而是彻底重启进程)
切换语言必须执行 Configure Display Language 命令
装完插件 ≠ 界面变中文。它只是把翻译资源放进了本地,真正启用要靠命令触发。很多用户卡在这步,以为装完就自动生效。
操作要点:
- 按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language(注意大小写和空格,不能缩写) - 从下拉列表选
zh-cn—— 必须小写、短横线,zh_CN或zh-CN都不识别 - 弹出“是否重启窗口”时,点
Yes;如果点了“否”,配置不会加载
locale.json 文件手动配置是兜底方案
命令面板打不开、选了 zh-cn 但重启后仍是英文,说明 VSCode 没读到 locale 设置。这时候直接改配置文件最稳,且绕过所有 UI 层干扰。
路径和内容要严格匹配:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json - 文件内容只能是:
{"locale":"zh-cn"},编码必须为 UTF-8 无 BOM - 改完后务必彻底退出 VSCode:Windows 查任务管理器确认
Code.exe进程已结束;macOS/Linux 用killall Code清干净
别碰其他名字带“中文”的插件
像 Chinese Language Pack、VSCode Chinese、vscode-language-pack-zh-hans(没带 Microsoft 认证)这类插件,要么是旧版弃用包,要么是社区魔改版,容易导致:
- 命令面板里
Configure Display Language消失 - 设置里
locale字段被写成无效值(如zh) - 升级后插件失效,但界面语言回退成英文且无提示
真正影响体验的只有三处:顶部菜单栏、命令面板提示文字、设置页面标题。终端输出、调试控制台、Git 日志这些本就不走 locale,看到英文不用慌。











