VSCode字体不清晰、连字不生效或设置无反应，主因是字体名错误、配置项混淆或环境未对齐；需正确填写editor.fontFamily（如"'Fira Code', 'JetBrains Mono', monospace"）、启用editor.fontLigatures、单独配置terminal.integrated.fontFamily及fontSize，并确保字体已安装且系统名一致。
VSCode 编辑器字体不清晰、连字不生效、改了设置没反应——基本都是字体名填错、配置项用混、或环境没对齐导致的，不是 VSCode 本身有问题。
editor.fontFamily 怎么填才真正生效
直接写 "Fira Code" 在 Windows 上可能行，在 macOS 上大概率失败。系统注册的字体名和你看到的文件名经常不一致。
- Windows 用户：优先试
"Fira Code"或"JetBrains Mono"，注意空格不能少，也不能多 - macOS 用户：打开「字体册」→ 找到对应字体 → 右键「显示简介」→ 复制「全名」字段（比如
"FiraCode-Retina"或"JetBrainsMono Nerd Font"） - Linux 用户：运行
fc-list | grep -i "fira\|jetbrains"确认实际注册名 - 务必用英文引号包裹每个字体，并用英文逗号分隔：
"'Fira Code', 'JetBrains Mono', 'Consolas', monospace" - 字体必须已安装进系统（双击 .ttf/.otf 安装），VSCode 不读取未注册字体文件
为什么开了 editor.fontLigatures 却看不到 != 变成 ≠
连字不是 VSCode 自带功能，它依赖字体 OpenType 表 + 配置双激活。常见失效不是设置漏了，而是字体压根不支持或没加载成功。
- 确认字体明确支持编程连字：查官网或 GitHub README，搜
ligature；Consolas、Source Code Pro原生不支持，别试 - VSCode 1.84+ 对连字支持更稳，旧版本可能部分符号（如
==>）不合并 - 某些字体需显式启用 OpenType 特性：
"editor.fontLigatures": "'calt' on, 'liga' on"（仅限支持 OpenType 的字体） - 改完配置必须重启 VSCode（尤其 macOS 解压安装后）
terminal.integrated.fontFamily 和 editor.fontFamily 是两套配置
改了 editor.fontFamily，终端还是默认字体？正常。VSCode 的编辑器和集成终端使用完全独立的字体配置项。
- 终端字体必须单独设：
"terminal.integrated.fontFamily": "'Fira Code', 'monospace'" - 终端字号也要单独配：
"terminal.integrated.fontSize": 14（旧键名terminal.fontSize已弃用） - 已打开的终端页签不会热更新字体，必须新建一个才能看到效果
- 远程开发（SSH/WSL/Dev Container）下，字体必须装在远程系统上，本地装了无效
行高、抗锯齿、GPU 加速这些细节怎么调才不糊
只调 editor.fontSize 不够，行距过紧、光标偏移、字体发虚，往往是配套参数没对齐。
- 显式设
editor.lineHeight：默认为 0（自动计算），但某些字体在非整数字号下度量异常；建议设为24或1.4（字号 × 1.4） - 抗锯齿无法通过 settings.json 开启，它是 Electron 渲染层行为；若字体模糊，可尝试启动时加参数：
--enable-font-antialiasing --font-render-hinting=medium（但 VSCode 1.85+ 已限制部分标志） - 某些显卡驱动下 GPU 加速反而导致字体渲染异常，临时验证可用：
code --disable-gpu - 别碰
window.zoomLevel：它是整个 UI 缩放，会导致图标错位、字体发虚；想调代码清晰度，只动editor.fontSize和editor.lineHeight
最常被忽略的是：改了字体大小却没同步调行高，结果光标卡在字符中间、括号匹配线错位——这不是 bug，是渲染度量没对齐。字体设置从来不是单点调整，而是一组协同参数。
