Sublime Text字体模糊主因是font_options与系统渲染路径不匹配:Windows高分屏须设["directwrite"]并校准ClearType、禁用DPI缩放覆盖;macOS Retina屏须设["gray_antialias"]并执行AppleFontSmoothing=2;Linux建议删除font_options交由GTK/freetype处理。

Sublime Text 字体模糊不是字体选得不好,也不是软件坏了,而是 font_options 和系统渲染路径没对上——配错比不配还糊,尤其在高分屏、中文字体、多显示器场景下。
Windows 高分屏必须用 ["directwrite"],别碰 subpixel_antialias
Sublime Text 4 Build 4126+ 默认走 GDI 渲染,对“微软雅黑”“思源黑体”这类中文字体的 hinting 和 subpixel 定位支持极差,小字号边缘毛刺、字重不均、发虚就是典型表现。
-
font_options必须设为["directwrite"]—— 写成字符串"directwrite"或漏掉方括号会静默失效 - 系统 ClearType 必须全程完成校准:控制面板 → 显示 → 调整 ClearType 文本 → 每一步都点“下一步”,只勾选不操作等于没开
- 右键 Sublime 快捷方式 → 属性 → 兼容性 → 勾选「替代高 DPI 缩放行为」→ 下拉选「应用程序」,否则 Windows 强制位图拉伸,DirectWrite 根本不触发
- 显卡驱动里若开了「覆盖应用程序抗锯齿设置」,临时关掉再测试——它会把 DirectWrite 降级回 GDI
- 别混写
["directwrite", "subpixel_antialias"]:冲突后只生效第一个,且后者在高分屏上反而泛绿边
macOS Retina 屏只认 ["gray_antialias"],subpixel_antialias 是雷区
Retina 屏物理像素密度太高,子像素渲染在硬件层面已失效。强行启用 subpixel_antialias 不是“没效果”,而是让中英文边缘泛绿/泛红、整体发虚、纤细无力。
- 先在终端执行:
defaults write -g AppleFontSmoothing -int 2(2 是中等平滑强度,0=关,3=最强) - 用户设置中只加:
"font_options": ["gray_antialias"],删掉所有no_antialias或subpixel_antialias行 -
font_size小于 11.0 时,Core Text 会自动禁用抗锯齿,建议设为 11.5 或 12.0 - 第三方主题(如 ayu、Material Theme)常在
.sublime-theme里硬编码font_options,需全局搜索并统一替换为["gray_antialias"]
Linux 下建议直接删掉 font_options 字段
Linux 字体渲染高度依赖桌面环境(GNOME/KDE)、GTK/Qt 和 freetype 配置。font_options 不是指令,只是建议;填错会干扰系统默认行为。
- 多数现代发行版(GNOME 42+/KDE Plasma 6+)直接删掉
font_options字段最稳,让 GTK/freetype 自行决策 - 若必须干预,试
"font_options": ["antialiased"](注意拼写,不是antialias或字符串"antialiased") - 别用
subpixel_antialias:Wayland 会无视,X11 下易与 fontconfig 冲突 - VNC 环境下还需前置设置:
export GDK_SCALE=1、export GDK_DPI_SCALE=1、export XFT_DPI=96,否则 X11 回退到灰度抗锯齿
改完必须彻底退出,热重载不触发渲染管线重初始化
真正卡住的地方,往往不是数值填多少,而是改完没彻底退出;也不是主题没换,而是 font_options 在 .sublime-theme 里被硬编码覆盖了,或者系统级抗锯齿根本没开。
- Windows/macOS/Linux 都要通过菜单栏「Sublime Text → 退出」或托盘右键 → Exit 杀掉所有进程,仅关闭窗口不行
- 确认系统级抗锯齿是否启用:Windows 查 ClearType 向导是否完成,macOS 查
defaults read -g AppleFontSmoothing是否返回 2,Linux 查GDK_SCALE是否生效 - 侧边栏、标签页文字太小?
font_size对它们无效,ST4.4277+ 才支持ui_font_size,旧版必须改主题文件 - 图标模糊?和字体无关,是主题没提供 @2x 图标资源,换 Ayu 或 Material Theme 即可


















