vscode 1.80+ 版本已内置简体中文语言包,无需安装插件,只需执行 configure display language 命令选择 zh-cn 并彻底重启(cmd+q 后重开),确保 locale.json 正确生成于用户级路径即可启用中文界面。

VSCode 自带中文语言包怎么启用
VSCode 从 1.80 版本起已内置中文(简体)语言包,无需额外安装插件。只要系统区域设置或 VSCode 首选项中启用了对应语言,就会自动生效。
常见误区是以为必须装 Chinese (Simplified) Language Pack for Visual Studio Code 才能用中文——其实这个插件现在只对旧版本(
- 打开 VSCode,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)调出命令面板 - 输入并执行
Configure Display Language - 在弹出的列表中选择
zh-cn,然后重启 VSCode
重启后界面即切换为中文。注意:该操作修改的是 locale.json 文件(位于 $HOME/.vscode/locales/ 或 Windows 的 %APPDATA%\Code\Locales\),不是安装插件。
手动安装语言包插件的适用场景
只有当你遇到以下情况时,才需要手动安装语言包插件:
- 使用的是老旧 VSCode 版本(如 1.75 及更早)
- VSCode 是通过 Snap、Flatpak 或某些 Linux 发行版仓库安装的,缺少内置语言资源
- 你正在调试多语言环境,需临时切换到特定语言版本做兼容性验证
此时可在扩展市场搜索 Chinese (Simplified) Language Pack for Visual Studio Code,点击安装即可。安装后仍需执行 Configure Display Language 并选 zh-cn 才生效。
⚠️ 注意:该插件安装后会覆盖内置语言资源,若 VSCode 升级到 1.80+,建议卸载它,避免 locale 冲突或翻译不一致。
语言包不生效的三个高频原因
即使选了 zh-cn 并重启,界面仍是英文?大概率卡在这几个环节:
-
locale.json被其他插件或脚本篡改,内容不是{"locale":"zh-cn"}—— 直接用文本编辑器打开该文件核对 - 启动 VSCode 时加了
--locale=en-us命令行参数(常见于桌面快捷方式或 shell 别名),会强制覆盖设置 - 设置了
"locale": "en"在settings.json里(错误写法),正确字段是"locale",但必须放在locale.json中,settings.json不识别该配置项
验证当前生效 locale 的最快方式:打开命令面板 → 运行 Developer: Show Running Extensions → 查看右上角显示的语言代码。
多语言协作时怎么保留英文界面
团队开发中常需保持英文 UI(比如截图报 bug、查英文文档、配合 CI 日志),但又想让中文用户看得懂提示——这时别动 locale.json,而是用「工作区级语言覆盖」:
- 在项目根目录创建
.vscode/settings.json - 加入:
{"locale": "en-us"}
这样打开该文件夹时自动英文,其他项目仍按全局 zh-cn 显示。注意:这个 locale 字段只在工作区 settings.json 中有效,且优先级低于 locale.json;如果全局已设 zh-cn,工作区设置会被忽略——所以实际要用,得先清空或注释掉 locale.json。
真正麻烦的不是装不装包,而是 locale 配置分散在三个地方:locale.json、命令行参数、工作区 settings.json,任一冲突都会导致预期外的语言行为。











