vscode 中文界面需同时安装中文语言包并设置 locale 为 zh-cn,仅做其一无效;推荐用命令面板执行 configure display language 并重启,若失败需检查网络、远程环境或组策略限制。

VSCode 默认不带中文界面,必须手动安装语言包并切换区域设置才能生效。只改 locale 配置但没装语言包,重启后仍是英文;反过来,装了语言包但没切 locale,也不会变中文。
用命令面板快速切换显示语言
这是最可靠、也最常被推荐的操作路径,全程在 VSCode 内完成,不碰配置文件:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language,回车执行 - 在弹出列表中选择
zh-cn(简体中文),VSCode 会自动下载并提示“Restart” - 点击重启,或手动关闭再打开
这个操作本质是修改 locale.json 文件里的 "locale": "zh-cn" 字段,并确保对应语言包已启用。如果第一次执行时没反应或卡住,大概率是网络问题导致语言包没下下来——可以手动检查扩展市场是否已安装 Chinese (Simplified) Language Pack for Visual Studio Code。
为什么装了语言包还是英文?常见断点排查
语言包安装成功 ≠ 界面立刻变中文,中间有多个依赖环节容易断裂:
-
locale.json文件可能被其他插件或同步功能覆盖,位置在:$HOME/.vscode/argv.json(Linux/macOS)或%APPDATA%\Code\argv.json(Windows),里面应含"locale": "zh-cn" - 远程开发(SSH / WSL / Containers)场景下,语言包必须在远程环境里单独安装,本地装了没用
- 某些企业策略或组策略会强制锁定
argv.json,导致切换无效;可尝试用管理员权限启动 VSCode 再试一次 - 旧版 VSCode(zh-cn 支持不稳定,建议升级到最新稳定版
终端和错误信息为什么还是英文?不是没汉化成功
VSCode 界面语言只控制菜单、设置面板、命令面板等外壳部分,不影响以下内容:
- 集成终端(Terminal)输出:由 shell、系统 locale、Python/Node.js 等运行时自身决定,与 VSCode 无关
- 编译器/解释器报错(如
gcc、javac、pylint):取决于工具链是否提供中文本地化,多数不支持 - 第三方插件的提示文案:只有插件作者主动适配了 i18n 才会随 VSCode 切换语言,否则保持英文
所以看到调试控制台里一堆英文报错,不是 VSCode 汉化失败,而是这些内容根本不在它的翻译管辖范围内。
字体和中文注释乱码要单独处理
界面变中文后,如果编辑器里中文注释显示为方块或问号,说明字体不支持中文渲染:
- 在设置中搜索
editor.fontFamily,填入支持中文的字体,例如:"Microsoft YaHei", "SimSun", "PingFang SC", "sans-serif" - 不要只写一个字体名,用英文逗号分隔,形成 fallback 链;否则某字体缺失时直接崩成等宽默认字体
- 同时确认文件编码是
utf8:搜索files.encoding,设为utf8;底部状态栏点击编码可临时重载
真正容易被忽略的是:字体设置和编码设置都得在用户级(User)而非工作区级(Workspace)生效,否则换个项目又变乱码。











