windows高分屏需设"font_options": ["directwrite"]并启用cleartype;macos retina屏用["gray_antialias"]且font_size≥11.5;linux建议留空font_options,避免冲突。

字体模糊不是主题坏了,而是 font_options 渲染策略和系统底层不匹配——配错比不配还糊,尤其在高分屏+中文字体组合下。
Windows 高分屏必须用 ["directwrite"],别碰 gdi 或 subpixel_antialias
Sublime Text 4 Build 4126+ 默认走 GDI,对“微软雅黑”“思源黑体”等中文字体的 hinting 和 subpixel 定位支持极差,小字号毛边、字重不均、边缘发虚都是典型表现。
- 用户设置里只加这一行:
"font_options": ["directwrite"](必须是数组,写成字符串或漏方括号会静默失效) - 系统 ClearType 必须启用:控制面板 → 显示 → 调整 ClearType 文本 → 全程完成向导(只勾选不校准等于没开)
- 右键 Sublime 快捷方式 → 属性 → 兼容性 → 更改高 DPI 设置 → 勾选「替代高 DPI 缩放行为」并选「应用程序」
- 显卡驱动里若开了「覆盖应用程序抗锯齿设置」,临时关掉再测试
- 别混写
["directwrite", "subpixel_antialias"]:冲突后只生效第一个,且后者在 Windows 上已过时
macOS Retina 屏只认 ["gray_antialias"],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(菜单栏「Sublime Text → 退出」),热重载不触发渲染管线重初始化
- 第三方主题(如 ayu、Material Theme)常在
.sublime-theme里硬编码font_options,搜一遍删掉或统一改成["gray_antialias"]
Linux 下留空 font_options 最稳,乱填反而更糊
Linux 字体渲染高度依赖桌面环境(GNOME/KDE)、GTK/Qt 和 freetype 配置。font_options 不是指令,只是建议;填错会干扰系统默认行为。
- 多数现代发行版直接删掉
font_options字段最稳,让 GTK/freetype 自行决策 - 若必须干预,试
"font_options": ["antialiased"](注意不是"antialias"字符串),别用subpixel_antialias(Wayland 会无视,X11 下易与 fontconfig 冲突) - 确保环境变量
GDK_SCALE=2已生效,且桌面缩放设为 200%;否则即使字体调大,图标和 UI 元素仍模糊
真正卡住的地方,往往不是数值填多少,而是改完没彻底退出;也不是主题没换,而是 font_options 被第三方主题文件里的硬编码覆盖了——得进 Packages/User/ 或对应主题目录手动清理。











