Sublime Text 字体模糊主因是渲染路径不匹配系统能力：Windows 高分屏须配 "font_options": ["directwrite"] 并启用 ClearType、DPI 缩放设为“应用程序”；macOS Retina 屏须用 ["gray_antialias"] 且系统执行 defaults write -g AppleFontSmoothing -int 2；Linux 推荐留空或设 ["antialiased"]，禁用硬件加速并确保 GDK_SCALE 正确；所有平台均需整数 font_size（≥11）并完全退出后重启。

Sublime Text 字体模糊不是字体选得不对，也不是软件坏了，而是渲染路径没对上系统能力——font_options配错、系统级抗锯齿关着、DPI 缩放被绕过，三者占其一，字就糊。

Windows 高分屏必须用 directwrite，别碰 gdi 或 subpixel_antialias

Sublime Text 4 Build 4126+ 在 Windows 上默认走 GDI 渲染，对“微软雅黑”“思源黑体”这类中文字体的 hinting 和 subpixel 定位支持极差，小字号毛边、字重不均、边缘发虚都是典型表现。

• 用户设置里只加这一行："font_options": ["directwrite"]（必须是数组，写成字符串会静默失效）
• 系统 ClearType 必须启用：控制面板 → 显示 → 调整 ClearType 文本 → 全程完成向导（只勾选不校准也无效）
• 右键 Sublime 快捷方式 → 属性 → 兼容性 → 更改高 DPI 设置 → 勾选「替代高 DPI 缩放行为」→ 下拉选「应用程序」
• 显卡驱动里如果开了「覆盖应用程序抗锯齿设置」，临时关掉再测试
• gdi 和 subpixel_antialias 在高分屏上反而加重模糊，尤其混用如 ["directwrite", "subpixel_antialias"] 会冲突，只生效第一个

macOS Retina 屏只认 gray_antialias，subpixel_antialias 是反效果

Retina 屏物理像素密度太高，子像素渲染不仅无效，还会让文字泛绿边、发虚、纤细无力——这不是字体问题，是渲染机制和硬件不匹配。

• 先在终端运行：defaults write -g AppleFontSmoothing -int 2（2 是中等平滑强度，0=关，3=最强）
• 用户设置里只加："font_options": ["gray_antialias"]（别混 subpixel_antialias）
• font_size 小于 11.0 时，Core Text 会自动降级为无抗锯齿，建议设为 11.5 或 12.0
• 改完必须完全退出 Sublime（右上角「退出 Sublime Text」，不是关窗口），否则热重载不生效
• 第三方主题（如 ayu、Material Theme）常在自己的 .sublime-theme 文件里硬编码 font_options，搜一遍删掉或统一改成 ["gray_antialias"]

Linux 下乱加 font_options 反而更糊，优先留空或用 antialiased

Linux 字体渲染高度依赖桌面环境（GNOME/KDE）、GTK 版本和 freetype 配置。font_options 不是开关，加错可能被忽略甚至触发 fallback 行为。

• 多数现代发行版（GNOME 40+/KDE Plasma 5.24+）直接留空 font_options 效果最好，让系统接管
• 若必须指定，用 ["antialiased"] 或 ["rgba"]；subpixel_antialias 在 Wayland 下会被无视，X11 下还可能和 fontconfig hinting 冲突
• 确保环境变量生效：GDK_SCALE=2（对应 200% 缩放），否则 UI 和字体缩放不同步，看着就是糊的
• 检查是否启用了硬件加速："hardware_acceleration": "opengl" 会跳过 GTK 文本渲染管线，导致 font_options 完全失效；临时改成 "none" 测试
• 确认 ~/.config/fontconfig/fonts.conf 启用了抗锯齿：<edit name="antialias" mode="assign"><bool>true</bool></edit>

所有平台都容易踩的坑：UI 缩放 ≠ 字体清晰度

很多人以为调大 ui_scale 就能解决模糊，其实它只是图像缩放，先渲染再拉伸，属于二次失真。真正影响字体清晰度的是 font_size（整数） + 匹配系统的 font_options。

• ui_scale 控制菜单、侧边栏、标签页大小，但不控制编辑区文字；它必须配合 dpi_awareness 才生效（Windows 上缺一不可）
• 避免 font_size 用小数（如 12.5），Sublime 不支持亚像素缩放，只会强制插值，加剧模糊
• 中文字体混排时，font_face 推荐 fallback 写法："Fira Code, PingFang SC, Microsoft YaHei"，确保英文等宽、中文可读
• 主题图标模糊？和字体无关，看是否含 @2x 资源（如 folder-open@2x.png）；手动改 Default.sublime-theme 的 icon 路径没配套资源只会更糊
• 改完配置不完全退出再重启，等于没改——这是最常被忽略的一步