VSCode 的 editor.fontFamily 和 workbench.fontFamily 独立控制代码区与 UI 字体，需分别配置中英混排字体链及中文字体 fallback，注意引号包裹、系统字体差异、GPU 缓存与插件冲突。
VSCode 的 editor.fontFamily 和 workbench.fontFamily 是独立控制的
VSCode 从 1.80 版本起正式支持 UI（菜单、侧边栏、标题栏等）和编辑器（代码区）使用不同字体。关键在于两个配置项互不干扰：editor.fontFamily 控制代码区域，workbench.fontFamily 控制所有非编辑器界面元素。
常见错误是只改 editor.fontFamily，结果发现设置页、搜索框、状态栏还是英文默认字体——那是因为 UI 字体压根没动过。
-
workbench.fontFamily默认为空，此时回退到系统 UI 字体（Windows 是 Segoe UI，macOS 是 San Francisco），对中文显示通常不够友好，尤其在高分屏上容易发虚或字重过轻 -
editor.fontFamily默认是"Consolas, 'Courier New', monospace"，纯英文字体，直接塞中文字体进去会导致英文字符渲染变丑（比如Fira Code遇到中文会 fallback 到系统宋体，字宽/基线不一致） - 推荐组合：UI 用无衬线中文字体（如
"Microsoft YaHei", "PingFang SC", "Noto Sans CJK SC"），代码区用等宽中英混排字体（如"Fira Code", "JetBrains Mono", "Cascadia Code"+ 中文 fallback）
中英文混排字体必须显式声明 fallback 链，不能只写一个中文字体名
VSCode 不会自动为英文字符找中文字体里的对应字形。如果你在 editor.fontFamily 里只写 "Microsoft YaHei"，所有英文、数字、符号都会被强制用微软雅黑渲染，结果就是字母歪斜、连字失效、括号不对齐。
正确做法是把主力等宽英文字体放前面，再用逗号接中文字体 fallback：
"editor.fontFamily": "'Fira Code', 'JetBrains Mono', 'Microsoft YaHei', 'Noto Sans CJK SC', monospace"
注意几点：
- 中文字体名带空格时必须用单引号包裹，否则 VSCode 解析失败，退回到默认字体
- macOS 用户优先用
"PingFang SC"或"SF Pro Display"，别硬套 Windows 字体名 - Linux 用户需确认系统已安装对应字体（比如
fonts-noto-cjk），否则 fallback 无效，最终显示方块 - 不要在
workbench.fontFamily里加monospace，UI 字体用比例字体更自然
字体渲染模糊？检查 electron.gpuCacheSizeInMB 和系统抗锯齿设置
即使字体选对了，部分用户仍反馈中文发虚、边缘毛刺。这往往不是配置问题，而是 Electron 渲染层的 GPU 缓存或系统字体平滑策略冲突。
可尝试以下实操步骤：
- 在 VSCode 设置中搜
electron.gpuCacheSizeInMB，设为0（禁用 GPU 字体缓存），重启生效；很多 Win11 + Intel 核显用户因此解决模糊 - Windows 用户检查「设置 > 轻松使用 > 文字大小」是否开了「让文本更清晰」（ClearType），若关闭则开启并运行 ClearType 调谐器
- macOS 用户在「系统设置 > 显示器 > 字体平滑强度」调至中间偏右，避免过锐或过糊
- 如果用了自定义主题（尤其是暗色主题），确认主题未覆盖
workbench.colorCustomizations中的字体相关 CSS 变量
插件可能覆盖字体设置，特别是图标类插件
像 vscode-icons、Material Icon Theme 这类插件，会在激活时注入自定义 CSS，其中可能包含 font-family 声明，意外影响文件资源管理器或标签页字体。
验证方法：禁用所有插件，重启 VSCode，看 UI 字体是否恢复正常。若恢复，则逐个启用排查。
- 常见冲突点是插件修改了
.monaco-workbench .part.titlebar或.explorer-folders-view的字体样式 - 某些插件提供
iconTheme.fontFamily类配置项，但实际是伪配置，不起作用，得去插件源码里删 CSS - 最稳妥方案：在
settings.json底部加一条强制重置：
"workbench.colorCustomizations": {
".monaco-workbench .part.titlebar": { "font-family": "'Microsoft YaHei', sans-serif" }
}
字体这事没有银弹，每个系统、每块屏幕、甚至每次 VSCode 升级都可能带来新表现。调完记得关掉所有窗口再开，别只靠重载窗口——有些字体样式只在启动时读一次。
