vscode 中文显示模糊的根本原因是系统级字体渲染配置未对齐：windows需cleartype校准+整数缩放，macos需vscode 1.85+（electron 24+）支持core text，linux则依赖fontconfig的rgba与hinting配置。
VSCode 中文显示模糊、发虚、边缘毛刺，不是字体选得不对，而是系统级渲染链路没对齐——Windows 要 ClearType + 整数缩放双生效，macOS 必须 VSCode 1.85+（Electron 24+）才走 Core Text，Linux 则完全依赖 fontconfig 配置。改 editor.fontFamily 或调 editor.fontSize 解决不了根本问题。
Windows 下中文发虚：ClearType 没校准 + 缩放值非整数
你换成了“霞鹜文楷”或“微软雅黑”，但中文还是灰蒙蒙的？大概率是 ClearType 根本没启用，或者系统缩放设成了 125%、133% 这类非整数值。
- 必须运行「控制面板 > 外观和个性化 > 显示 > 调整 ClearType 文本」，全程勾选「启用 ClearType」，每一步样本页都点“下一步”，不能跳过校准
- 右键桌面 →「显示设置」→ 关掉「修复应用缩放问题」，否则会强制回退到 GDI 渲染，直接废掉子像素抗锯齿
-
window.zoomLevel必须为0；系统缩放必须是整数倍（如 100%、125%、150%），133%、110% 这类值会让 DirectWrite 插值失真，中文字边缘立刻晕染 - 检查
settings.json里有没有"window.nativeTabs": false——有就删，这个值会绕过 D2D 渲染通道，中文直接降级为灰阶模糊
macOS 上中文发灰：VSCode 版本太低或字体平滑被禁用
你在 settings.json 里加了 -webkit-font-smoothing: antialiased，或把 editor.foreground 透明度调高，全无效。因为 macOS 13+ 已全面切到 Core Text 渲染管线，而 VSCode 1.84 及更早版本压根不支持。
- 必须升级到 VSCode
1.85+（2026 年 4 月已稳定发布），旧版本再怎么调设置都没用 - 系统设置 →「显示器」→「字体平滑强度」拖到最右；外接显示器时，「缩放」必须选「默认」，不能选「缩放分辨率」
- 别在
editor.fontFamily里显式声明Monaco作中文回退——它在非原生 macOS 环境下无完整 hinting，装了也白搭 - 中文字体链要显式写全：
"editor.fontFamily": "Cascadia Code, 'Microsoft YaHei', 'Noto Sans CJK SC', monospace"，单引号必须用英文双引号包裹，否则解析失败
Linux 中文字体糊：fontconfig 配置比 VSCode 设置更关键
VSCode 自身几乎不干预 Linux 字体渲染，真正起作用的是系统级 fontconfig。终端里中文粘连、编辑器里小字号糊成块，八成是 rgba 模式没开或 hinting 强度太低。
- 确保
/etc/fonts/conf.d/10-sub-pixel-rgb.conf已软链接启用（或手动创建），开启 sub-pixel 渲染 - 在
~/.fonts.conf或~/.config/fontconfig/fonts.conf中显式启用 rgba 和 hinting：<match target="font"><edit name="rgba" mode="assign"><const>rgb</const></edit><edit name="hinting" mode="assign"><bool>true</bool></edit><edit name="hintstyle" mode="assign"><const>hintslight</const></edit></match>
-
fc-cache -fv刷新缓存后，重启 VSCode 才生效 - VSCode 的
editor.fontFamily建议只留一个高质量中文字体，比如'Noto Sans CJK SC'，避免多字体 fallback 导致渲染策略冲突
真正容易被忽略的是：这些设置全生效后，仍需关掉所有 VSCode 进程（pkill -f "code" 或任务管理器杀光），否则旧渲染上下文会残留；另外，WSL 或 Remote-SSH 中的 VSCode Server 实例，必须单独配置远程机器上的 fontconfig 和 locale，本地改了毫无意义。
