VSCode中文字体需在settings.json中配置editor.fontFamily,按回退顺序列出英文字体、系统中文字体(如Microsoft YaHei/PingFang SC/Noto Sans CJK SC)及'sans-serif'保底,字体名含空格须加英文单引号,修改后保存即生效。

VSCode 中文字体设置在哪改
VSCode 默认不单独控制中文字体,它用的是整体 editor.fontFamily 设置,靠字体列表的“回退机制”来显示中文——也就是说,你得在字体名里按优先级写一串字体,让系统在前一个不支持中文时自动切到下一个。Windows、macOS、Linux 的常用中文字体名还不一样,直接抄别人配置容易显示方块或英文 fallback。
怎么写正确的中文字体配置
打开设置(Ctrl+, ),搜 font family,点右侧铅笔图标编辑 editor.fontFamily;或者直接打开 settings.json,加这一行:
"editor.fontFamily": "'Fira Code', 'Microsoft YaHei', 'PingFang SC', 'Noto Sans CJK SC', 'sans-serif"
说明:
• 'Fira Code' 是主力编程字体(等宽、有连字),但它不含中文,所以必须接一个支持中文的字体
• 'Microsoft YaHei'(Win)、'PingFang SC'(macOS)、'Noto Sans CJK SC'(跨平台开源,推荐装)是常见中文选项,用英文逗号分隔,顺序即回退顺序
• 最后加 'sans-serif' 是保底,防止所有字体都缺失时崩掉
- 别用全角引号或中文顿号,必须是英文单引号 + 英文逗号
- 字体名含空格必须加单引号,比如
'Source Han Sans CN' - 改完不用重启,保存即生效(但旧标签页可能要手动刷新)
为什么改了还是显示英文/方块字
常见原因不是配置错,而是字体根本没装或名字对不上:
- macOS 上
PingFang SC是系统自带,但某些精简版或老系统可能没有;可运行fc-list :lang=zh | head -n 5(Linux/macOS)查已安装中文字体 - Windows 用户若装了新字体(比如
Sarasa Gothic),要确认它是“为所有用户安装”,否则 VSCode 可能读不到 - VSCode 启动时加载的是用户级字体缓存,如果刚装完字体就改配置,建议先关掉所有 VSCode 进程再重开
-
editor.fontFamily只影响编辑器区域;菜单、侧边栏等 UI 字体由workbench.fontAliasing和系统语言包共同决定,和这里无关
要不要额外调 editor.fontSize 或 editor.fontLigatures
中文字体一般比英文字体视觉上偏大,尤其 Microsoft YaHei 在小字号下易糊。如果你设了 14px 英文字体看着刚好,中文可能需要微调:
- 中文显示发虚?试试关掉
editor.fontLigatures(连字对中文无意义,反而干扰渲染) - 行高太挤?加
"editor.lineHeight": 24(数值单位是像素,不是倍数) - 想统一中英文等宽体验?推荐
Sarasa Gothic SC或Noto Sans Mono CJK SC,它们是真正等宽中文字体,但需手动下载安装
字体这事没法一次配齐,不同项目、不同显示器、不同缩放比例下表现都可能不一样。最稳的做法是:先用 Noto Sans CJK SC 打底,再根据实际看哪段文字糊、哪行挤,针对性换字体名,而不是迷信某份“终极配置”。










