windows高分屏必须用directwrite，macos retina屏必须用gray_antialias，linux通常留空最稳；配错font_options会导致字体更糊、泛绿边或发虚，且须同步开启系统级抗锯齿（如cleartype）、禁用dpi缩放干预并完全重启sublime。
Windows 高分屏必须配 directwrite，macOS Retina 屏必须用 gray_antialias，Linux 大部分情况留空反而最稳——配错 font_options 不是“没效果”，而是让字更糊、泛绿边、小字号直接发虚。
Windows 上为什么加了 font_options 还是模糊？
根本不是 Sublime 没读配置，而是渲染路径被系统级设置拦住了：
-
font_options必须写成数组格式："font_options": ["directwrite"]，写成字符串或漏掉方括号会静默失效 - 系统 ClearType 必须启用：控制面板 → 显示 → 调整 ClearType 文本 → 全程走完向导（只勾选不校准等于没开）
- 右键 Sublime 快捷方式 → 属性 → 兼容性 → 勾选「替代高 DPI 缩放行为」→ 下拉选「应用程序」，否则 Windows 会强制缩放 UI 层，绕过 DirectWrite
- 显卡驱动里如果开了「覆盖应用程序抗锯齿设置」，临时关掉再测试——它会强行把 DirectWrite 降级为 GDI
- Sublime Text 4 Build 4126+ 才真正支持
directwrite，旧版即使写了也无效
macOS Retina 屏上 subpixel_antialias 是雷区
不是它“不工作”，而是物理层面失效：Retina 屏像素密度太高，子像素定位失去意义，强行开启会导致中英文边缘泛绿/泛红、整体发虚、纤细无力。
- 终端先执行：
defaults write -g AppleFontSmoothing -int 2（2 是中等平滑强度，0=关，3=最强） - 用户设置里只加这一行：
"font_options": ["gray_antialias"]，别混subpixel_antialias或no_antialias -
font_size小于 11.0 时，Core Text 会自动禁用抗锯齿，建议设为11.5或12.0 - 改完必须完全退出 Sublime（不是关窗口），再重启；热重载不触发字体渲染管线重初始化
- 第三方主题（如 ayu、Material Theme）常在
.sublime-theme里硬编码font_options，搜一遍删掉或统一改成["gray_antialias"]
Linux 下乱加 font_options 反而更糊
GTK 和 Qt 环境下，字体渲染由桌面环境和 freetype 共同接管，font_options 不是开关，而是可能触发冲突的干预项。
- 多数现代发行版（GNOME/KDE）直接留空
font_options效果最好，让系统决定 - 若必须指定，用
["antialiased"]（注意不是antialias或antialiased字符串），别碰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>
最容易被忽略的是：所有修改都依赖系统级抗锯齿能力。ClearType / Core Text / freetype 没开，font_options 再怎么调也只是在“无源之水”上做文章。尤其是 Windows 用户，常以为配了就完事，其实三步缺一不可：开 ClearType → 设 directwrite → 关 DPI 注入。
