必须同时设置ui_scale、dpi_awareness和font_options,并禁用系统dpi注入,三者缺一不可;仅设ui_scale无效,因sublime默认以unaware模式启动,windows直接位图拉伸导致其被忽略。

Windows 上 Sublime Text 高分屏模糊,不是调个 ui_scale 就能解决的——必须同时打开 dpi_awareness、配对 font_options、禁用系统 DPI 注入,三者缺一不可;macOS 基本开箱即用,Linux 则靠桌面环境驱动。
为什么只设 ui_scale 没反应
很多人在 Preferences.sublime-settings 里加了 "ui_scale": 1.5 却毫无变化,根本原因是 Sublime 默认以 unaware 模式启动,Windows 直接对整个窗口做位图拉伸,ui_scale 被完全忽略。
-
dpi_awareness必须显式设为"per_monitor_v2"(Windows 10 1703+ 支持),不能留空或填"system" - 两项必须共存:
"ui_scale": 1.5和"dpi_awareness": "per_monitor_v2",顺序无关,但少一个都不生效 - 值要和系统缩放严格对应:系统设 150% → 填
1.5,填"150%"或150会静默失败 - 改完必须右键托盘图标 → Exit,杀掉所有
subl.exe进程,仅关闭窗口无效
font_options 配错比不配还糊
Windows 高分屏默认走 GDI 渲染,对“微软雅黑”“思源黑体”等中文字体 hinting 错位、灰阶不准,小字号直接毛边发虚——font_options 不是可选项,是必选项。
- Windows 推荐:
"font_options": ["directwrite"](必须是数组,写成字符串或漏方括号会静默失效) - 别混写:
["directwrite", "subpixel_antialias"]会冲突,只生效第一个 - 必须同步启用 ClearType:控制面板 → 调整 ClearType 文本 → 全程走完校准向导(只勾选不点下一步 = 没开)
- 右键快捷方式 → 属性 → 兼容性 → 「更改高 DPI 设置」→ 勾选「替代高 DPI 缩放行为」→ 下拉选「应用程序」
- 显卡驱动里若开了「覆盖应用程序抗锯齿设置」,临时关掉再测
侧边栏/标签页字体还是糊?它根本不认 font_size
font_size 只控制编辑区文字大小,侧边栏、标签页、状态栏的字号由 UI 主题文件硬编码决定,改 font_size 完全没用。
- 真正起效的是修改主题文件里的
font.size字段,路径一般是:Packages/Theme - Default/Default.sublime-theme - 搜索
"class": "sidebar_label"或"class": "tab_label",在其 block 中添加或修改:"font.size": 14 - 第三方主题(如
Material Theme)常自带@2x图标和适配规则,优先选用比硬改默认主题更稳 - 改完需 Ctrl+Shift+P → 输入
UI: Reload Theme,或彻底重启才生效 - macOS 上
font_size小于11.0时 Core Text 会自动禁用抗锯齿,建议设为11.5或12.0
最容易被跳过的动作是「彻底退出」——改完配置却只关窗口,Sublime 的渲染管线根本没重初始化,等于白调。多显示器场景下,per_monitor_v2 能自动切换缩放,但前提是快捷方式的兼容性设置已设为「应用程序」,否则副屏照样糊。











