sublime text 中文字体模糊源于 windows 默认使用 gdi 渲染,应启用 directwrite:在用户设置中添加 {"font_options": ["directwrite"]},确保 cleartype 开启、字体支持 hinting,并重启软件。

Sublime Text 中文字体模糊的根源是字体渲染策略
Sublime Text 默认在 Windows 上使用 GDI 渲染(而非 DirectWrite),而 GDI 对中文字体的 hinting 和 subpixel 定位支持弱,尤其在非整数缩放、高分屏或 ClearType 关闭时,微软雅黑、思源黑体 等常见中文字体就会发虚、毛边、字重不均。
这不是字体本身问题,也不是 Sublime 崩溃或配置错误,而是底层渲染路径选择导致的视觉缺陷。关键不是“换字体”,而是“改渲染方式”。
开启 DirectWrite 渲染(Windows 10/11 必做)
从 Sublime Text 4 Build 4126 起,Windows 版本支持通过 font_options 启用 DirectWrite,它能正确处理中文字体的灰阶抗锯齿与 subpixel 渲染。
- 打开
Preferences → Settings,在右侧用户设置中添加:
{
"font_options": ["directwrite"]
}
- 必须确保系统已启用 ClearType(控制面板 → 显示 → 调整 ClearType 文本),否则 DirectWrite 效果会退化
- 若同时设置了
font_face,请确认该字体支持 ClearType hinting(避免用某些精简版或旧版simhei.ttf) - 重启 Sublime 才生效;修改后仍模糊,可尝试临时禁用显卡驱动中的“覆盖应用程序抗锯齿设置”
macOS / Linux 用户别乱加 font_options
macOS 使用 Core Text,Linux 使用 FontConfig + FreeType,默认即启用高质量亚像素渲染,font_options 中填 directwrite 会被忽略,甚至触发未知 fallback 行为。
- macOS 上中文字体模糊更可能源于系统字体缓存损坏:运行
sudo atsutil databases -remove后重启 - Linux(如 Ubuntu)检查是否安装了
fonts-noto-cjk或fonts-wqy-zenhei,并在设置中明确指定:"font_face": "Noto Sans CJK SC" - 所有平台都应避免在
font_size中使用小数(如12.5),Sublime 不支持亚像素字体缩放,小数只会强制插值,加剧模糊
平滑缩放 ≠ 字体平滑,别混淆这两个概念
ui_scale 控制整个 UI(菜单、侧边栏、标签页)的缩放比例,它走的是图像缩放管线,和字体渲染无关。开 "ui_scale": 1.25 后字体反而更糊,是因为先渲染再缩放,属于二次失真。
- 真正影响字体清晰度的是
font_size(整数)+font_options(Windows 加directwrite) - 高分屏用户应优先调大
font_size(如从 10 改成 14),而不是依赖ui_scale - 如果必须缩放 UI,建议在系统级设置(Windows 显示设置 / macOS 缩放选项)中完成,让 Sublime 接收正确的 DPI 信息
最常被忽略的一点:改完 font_options 后没重启,或者用了带空格/全角引号的 JSON 格式导致配置加载失败——建议复制粘贴后用 Ctrl+Shift+P → “Syntax: JSON” 检查语法高亮是否正常。










