字体与主题需精准匹配，否则引发连字失效、语法色异常、括号错位、光标跳位等问题；macOS/高分屏更敏感；fontFamily须严格区分大小写、空格、连字符及引号；必须以monospace保底；tokenColorCustomizations需按scope精准覆盖且重启生效；终端字体需单独配置terminal.integrated.fontFamily并重开终端；字体渲染质量依赖系统级抗锯齿设置。
直接说结论：字体和主题不是随便配的，错配会导致连字失效、语法色被吞、括号对不齐、甚至光标跳位——尤其在 macOS 和高分屏上更明显。
VSCode 中 editor.fontFamily 必须写对大小写和引号
系统字体名区分大小写，空格和连字符一个都不能错。比如 JetBrains Mono 写成 jetbrains mono 或 Jetbrains Mono，VSCode 就会 fallback 到 monospace，连字直接消失。
-
Fira Code要完整写成'Fira Code'（带空格、首字母大写、单引号包裹） -
Cascadia Code不能漏掉Code，写成Cascadia无效 - Windows 上
'Cascadia Code', 'Consolas'是稳妥组合；macOS 上优先用'JetBrains Mono', 'SF Mono' - 所有字体列表末尾必须加
monospace保底，否则某些语言插件（如 Rust 的 rust-analyzer）可能渲染异常
深色主题下 workbench.colorTheme 和 editor.tokenColorCustomizations 冲突怎么办
很多用户手动改了 tokenColorCustomizations 后发现注释变黑、字符串看不清——其实是主题本身已定义了这些 token 颜色，你的自定义覆盖不完整，反而破坏了原主题的语义层级。
- 先用命令面板运行
Developer: Inspect Editor Tokens and Scopes，把光标停在 CSS 类名或 JS 变量上，看实际生效的scope名（比如entity.name.tag.css） - 不要全局重写
strings或comments，而是按 scope 精准覆盖，例如只调string.quoted.double.js - 如果用了 One Dark Pro 主题，别直接写
"[One Dark Pro]": { ... }，新版主题名实为"One Dark Pro Vivid"，写错就完全不生效 - 修改后必须重启 VSCode，
tokenColorCustomizations不支持热更新
为什么开了 editor.fontLigatures 却没效果
连字不是开关一开就自动出现的，它依赖三重条件同时满足：字体安装正确 + 字体名匹配 + 当前 token 被主题允许渲染为 ligature。
- 确认字体已真正安装到系统（macOS 在“字体册”里搜 Fira Code，Windows 在“字体设置”里查）
- 检查
editor.fontFamily是否包含该字体且排在最前（如'Fira Code', monospace） - 某些主题（如 SynthWave '84）会强制关闭连字渲染，此时需在
editor.tokenColorCustomizations中显式加"fontStyle": "normal"覆盖 - 部分语言模式（如 Markdown 预览、JSON）默认禁用 ligatures，需单独配置
"[json]": { "editor.fontLigatures": true }
终端字体和编辑器字体必须分开配
editor.fontFamily 对集成终端完全无效。你改了编辑器字体却看到终端还是小号模糊字？那是没动 terminal.integrated.fontFamily。
- 终端字体必须是系统已安装的等宽字体，且名称要和系统内完全一致（比如 macOS 上
'JetBrains Mono'，Windows 上'Cascadia Code'） - 终端字号独立控制：
terminal.integrated.fontSize，建议比编辑器大 1～2px（例如编辑器 14，终端设 15 或 16） - 终端配色不能只靠
terminal.integrated.colorTheme，它只控制基础 ANSI 色；要微调绿色/黄色高亮，得用workbench.colorCustomizations里的terminal.ansiGreen等字段 - 改完终端配置后，必须关闭现有终端页再新建一个，旧页不会刷新渲染
最容易被忽略的一点：字体渲染质量在不同 Electron 版本下差异极大。VSCode 1.89+ 已移除 --enable-font-antialiasing 启动参数支持，现在唯一可控的是系统级子像素抗锯齿开关——macOS 用户请检查“系统设置 > 显示器 > 字体平滑”，Windows 用户注意是否启用了“ClearType”。这些底层设置变了，VSCode 里调再多次 fontFamily 也白搭。
