VS Code 中文界面必须安装 Microsoft 官方简体中文语言包并手动配置 locale 为 "zh-cn",否则仅菜单可能变中文而设置项等仍为英文;离线环境可通过 .vsix 文件安装。

装对语言包:只认 Microsoft 官方的 Chinese (Simplified) Language Pack for Visual Studio Code
VS Code 的中文界面不是靠“汉化补丁”或第三方翻译插件实现的,装错包会导致菜单变中文、但设置项/命令面板/报错信息仍是英文,甚至引发乱码或崩溃。
- 打开扩展面板:
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS) - 搜索完整名称:
Chinese (Simplified) Language Pack for Visual Studio Code - 必须确认发布者是 Microsoft —— 不要选
Chinese Language Pack、VSCode Chinese等模糊名称 - 点击
Install,等状态变成Installed
切换语言必须手动触发:Configure Display Language 命令不能跳过
装完语言包 ≠ 界面自动变中文。它只是把翻译资源“备好了”,真正启用得靠命令激活,否则重启 VS Code 也还是英文。
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择:
Configure Display Language - 在弹出列表中选
zh-cn(注意是小写、连字符,不是zh_CN、zh-CN或Chinese) - 点
Restart或手动关闭再启动
如果重启后右下角状态栏仍显示 en,可直接点击它 → 选 zh-cn 快速验证是否生效。
手动改配置时:"locale": "zh-cn" 必须写对格式
当命令面板失效(比如插件冲突卡死),或需要批量部署时,就得编辑 JSON 配置。这里最容易出错的是大小写和分隔符。
- 打开设置 JSON:
Ctrl+,→ 右上角点Open Settings (JSON) - 添加或修改这一行:
"locale": "zh-cn" - 禁止写成:
"locale": "zh_CN"、"LOCALE": "zh-cn"、"locale": "Zh-cn" - 保存后执行:
Developer: Reload Window(不用全退出,但旧版本可能仍需重启)
如果没反应,先检查 JSON 是否多逗号、引号不匹配,或被其他插件(如某些主题)悄悄覆盖了 locale 值。
离线环境怎么办:用 .vsix 文件 + Install from VSIX
公司内网、教育网或强防火墙环境下,扩展市场打不开,但语言包本身是纯静态资源,完全支持离线安装。
- 从微软官方 GitHub 或可信镜像下载
.vsix文件(搜vscode-language-pack-zh-hans) - 在 VS Code 中执行:
Extensions: Install from VSIX... - 选中下载好的文件,安装后照常运行
Configure Display Language→zh-cn
离线安装后如果语言不生效,大概率是漏了这一步——语言包只是资源,zh-cn 这个开关永远得手动按一次。










