必须认准Microsoft发布的ms-ceintl.vscode-language-pack-zh-hans扩展,安装后需执行Configure Display Language并选zh-cn(小写连字符),再重启生效;settings.json中locale字段必须为"zh-cn",右下角显示zh-cn即验证成功。

安装官方中文语言包必须认准 Microsoft 发布者
VSCode 的中文界面不是靠“汉化补丁”或第三方翻译实现的,而是依赖微软官方发布的 ms-ceintl.vscode-language-pack-zh-hans 扩展。装错插件(比如 Chinese Language Pack 或 VSCode Chinese)会导致设置项乱码、命令面板崩溃,甚至干扰其他插件行为。
操作上只需三步:
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是
Microsoft、图标带蓝白 VS 标志,点击Install
装完不重启 = 白装。右下角弹窗出现后务必点 Restart Now;若没弹窗,手动关闭再启动 VSCode。
切换显示语言必须用 Configure Display Language 命令
语言包只是“字典”,不会自动激活。很多人装完就重启,结果界面仍是英文——因为 VSCode 默认仍沿用系统语言或上一次配置。
正确做法是:
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language - 在列表中选
zh-cn(注意:不是zh-CN、Chinese或zh_CN) - 点
Restart或手动重启窗口
重启后右下角状态栏会显示 zh-cn,这是最直接的生效验证方式。
settings.json 中 locale 配置必须小写连字符格式
当命令面板失效(如插件冲突、UI 卡死),或需批量部署时,得手动编辑配置文件。这里最容易出错的是格式和大小写。
打开 settings.json(Ctrl+, → 右上角点击 Open Settings (JSON)),添加或修改:
"locale": "zh-cn"
常见错误包括:
- 写成
"locale": "zh_CN"或"locale": "zhCN" - 漏掉引号、多加逗号导致 JSON 解析失败
- 被主题插件或其他扩展悄悄覆盖了该字段
改完保存后,执行 Developer: Reload Window(比全重启快),但旧版本 VSCode 仍需彻底重启。
插件界面汉化不全是设计限制,不是配置失误
官方语言包仅覆盖约 85% UI,右键菜单、GitLens 按钮、调试器标签、终端标题栏等由 Electron 底层或第三方扩展提供,locale.json 控制不了它们。
补全方案要分情况处理:
- 右键/上下文菜单:装
shengchen.vscode-chinese-menu,装完需重新呼出右键才生效(缓存刷新) - GitLens 等插件:单独在
settings.json里加"gitlens.language": "zh-cn" - 终端和调试控制台:本质是系统级输出,改
LANG=zh_CN.UTF-8(Linux/macOS)或系统区域格式(Windows)才有效
真正难补的是 WebView 类界面——比如 LeetCode 插件的题目页、Jupyter 的 notebook 渲染区,这些必须由插件作者自己实现翻译逻辑,外部无法强制干预。


















