必须选zh-cn而非zh_CN或zh;VSCode中文不生效90%因locale值错误,需通过命令面板运行Configure Display Language并选zh-cn后彻底重启,否则界面全英文。

Configure Display Language 必须选 zh-cn,不是 zh_CN 或 zh
VSCode 中文界面不生效,90% 是因为 locale 值写错了。装完 Chinese (Simplified) Language Pack for Visual Studio Code(发布者必须是 Microsoft)后,不执行这一步,等于没开电源。
按 Ctrl+Shift+P 打开命令面板,输入 Configure Display Language 并运行,在下拉列表中**必须点选 zh-cn**(全小写、短横线、BCP 47 标准)。填 zh_CN、zh、Chinese (Simplified) 都无效——它不会报错,但菜单、设置页、命令面板全部保持英文,右下角状态栏也一直显示 en。
验证是否真生效,只看三处:
- 顶部菜单栏(文件 / 编辑 / 视图)
- 命令面板提示语(“请输入命令或搜索设置”)
- 设置界面左侧导航(“用户 / 工作区 / 扩展”)
这三处变中文,才算成功。
editor.fontFamily 字体链顺序不能错:西文在前,中文兜底
中文注释发虚、断笔、标点挤在一起,根本不是语言没汉化,而是字体链没配对。VSCode 按 editor.fontFamily 从左到右逐个匹配字符,一旦某个字体不支持中文,就跳过,继续找下一个;如果整条链都没兜底,就 fallback 到系统默认字体——常见结果是方块、空白或极细宋体。
正确写法示例:"Fira Code", "JetBrains Mono", "Microsoft YaHei Mono", "PingFang SC", "Noto Sans CJK SC", "monospace"
- Windows 用户优先用
Microsoft YaHei Mono(注意是 Mono 变体,非普通微软雅黑) - macOS 用户避免
Microsoft YaHei,改用PingFang SC或Heiti SC;SF Mono必须放在中文字体前,否则{}等符号会变细 - Linux 用户推荐
Noto Sans CJK SC,确保系统已安装且字体全名匹配(不是文件名) - 所有字体名必须和系统注册的「字体全名」完全一致,大小写、空格、括号都不能错
terminal.integrated.fontFamily 和 debug.console.fontFamily 要单独设
编辑器里中文正常,但终端(Ctrl+`)或调试控制台里仍是方块或英文路径?这是最常被忽略的点:终端和调试器**完全不读取 editor.fontFamily**,它们有各自独立的字体配置项。
必须手动补上:
- terminal.integrated.fontFamily:建议和 editor.fontFamily 完全一致
- debug.console.fontFamily:同样建议设为相同值,否则断点输出里的中文变量名可能乱码
改完保存后,已打开的终端标签页需手动重启(关掉再开),调试控制台要重新触发断点才能看到效果。
字体名写错或系统未安装 = 静默失效
填了 SimSun 结果中文全变成方块;填了 Source Han Sans CN 却只显示英文——本质是字体名写错了,或系统根本没安装该字体。
VSCode 认的是系统注册的**字体全名**(Font Full Name),不是文件名。比如你下载了“思源黑体”,安装后在字体册里看到的可能是 Source Han Sans CN,但实际要填的是:
- macOS: Source Han Sans CN Normal
- Windows: Source Han Sans CN Regular
填错一个词,整条字体链就跳过它往下找。检查方法:
- 在代码里写一行中文注释,比如 // 测试中文,观察是否每个字宽度一致、边缘清晰
- 右键选中中文 → “检查元素”(DevTools),可看到最终生效的 font-family 值,对照你配置的字体链排查哪一环断了
最易被忽略的细节:字体链里所有含空格的字体名,必须用英文单引号包裹,例如:'Fira Code', 'Microsoft YaHei Mono';逗号后必须加空格;末尾加 monospace 保底,防止所有字体缺失时直接崩成 serif 字体。











