Sublime Text 高分屏模糊需同时配置 dpi_awareness="per_monitor_v2"、ui_scale(与系统缩放一致)、font_options=["directwrite"],并彻底退出重启;禁用系统DPI注入+ClearType校准可提升清晰度。

Sublime Text 在高分屏上模糊,不是“调个缩放就行”,而是必须同时解决 DPI 感知、UI 缩放、字体渲染三层问题。只改 ui_scale 或只开 ClearType,90% 的情况都无效。
Windows 必须设 dpi_awareness + ui_scale 才生效
很多用户在 Preferences.sublime-settings 里加了 "ui_scale": 1.5 却没反应,根本原因是 Sublime 默认以 unaware 模式启动,系统直接对整个窗口做位图拉伸——ui_scale 被完全忽略。
-
dpi_awareness必须设为"per_monitor_v2"(Windows 10 1703+ 支持),不能是"system"或空值 -
ui_scale值要和 Windows「显示设置 → 缩放与布局」数值一致:150% →1.5,125% →1.25,填"150%"或150都无效 - 两项必须同时存在,且只能写在
Settings – User(用户配置),改默认配置不生效 - 改完必须右键托盘图标 → Exit,再手动重启,仅关闭窗口不行
禁用系统 DPI 注入比硬调参数更可靠
尤其在多显示器场景(比如笔记本 150% + 外接 100% 屏),dpi_scale 和 ui_scale 只能按主屏缩放,副屏 UI 会偏小或发虚。这时候靠系统级干预反而添乱。
- 右键 Sublime 快捷方式 → 属性 → 兼容性 → 「更改高 DPI 设置」→ 勾选「替代高 DPI 缩放行为」,下拉选
应用程序 - 这个操作让 Windows 不再强行缩放进程,交由 Sublime 内部 DirectWrite 渲染处理
- 必须配合
"font_options": ["directwrite"]使用,否则字体仍可能毛边 - 副作用是状态栏/标签页略紧凑,但比模糊强得多
font_options 选错会让清晰度雪上加霜
font_options 不是开关,是告诉 Sublime “用哪种方式渲染字体”。选错类型,比如在 Windows 上用 ["gray_antialias"],文字反而发虚、纤细无力。
- Windows 高分屏推荐:
"font_options": ["directwrite"](Build 4126+ 原生支持,中英文都锐利) - 若用旧版或遇到兼容问题,可退而求其次:
"font_options": ["subpixel_antialias"] - 避免混写:
["directwrite", "subpixel_antialias"]会冲突,只生效第一个 - 必须提前开启并校准 Windows ClearType(运行
cttune.exe),否则所有配置都白搭
侧边栏和编辑区字号要分开调
ui_scale 控制按钮、菜单、侧边栏容器大小,但不控制侧边栏文字和代码字体大小。这两者是独立变量,混淆会导致“界面变大但字还是糊”。
- 侧边栏文字:需在
Packages/User/Default.sublime-theme中加规则:{"class": "sidebar_label", "font_size": 14} - 编辑区字体:直接在
Settings – User中设"font_size": 14(推荐偶数,如 12/14/16;避免 13/15) - 滚轮缩放(
Ctrl + wheel)默认可用,但高分屏下常被系统拦截;更稳的是用Ctrl + +/Ctrl + -键盘快捷键 - 第三方主题(如 ayu、Material)会覆盖
Default.sublime-theme,得去对应主题文件里改,或注释掉"theme"字段临时回落到默认主题验证
真正卡住的地方往往不是数值填多少,而是忘了右键托盘 → Exit —— 改完配置不彻底退出,等于没改。另外,directwrite 和 per_monitor_v2 这两个关键词,缺一不可,漏一个,模糊就还在那儿。











