windows下sublime text高分屏模糊需同时设置"dpi_awareness": "per_monitor_v2"和"ui_scale"(如1.5),缺一不可;macos原生支持无需dpi配置,linux依赖桌面环境缩放。

Sublime Text 在高分屏上模糊,不是字体问题,而是整个 UI 渲染被系统强制拉伸——必须同时设置 dpi_awareness 和 ui_scale,缺一不可;macOS 原生支持可跳过 DPI 配置,Linux 则依赖桌面环境缩放,唯独 Windows 必须手动干预。
Windows 上 ui_scale 单独设置无效的根本原因
很多人在 Preferences.sublime-settings 里加了 "ui_scale": 1.5 却毫无反应,是因为 Sublime Text(尤其是 v4)默认以“系统 DPI 感知模式”启动,但未声明为 per_monitor_v2。结果 Windows 强制对整个进程做位图拉伸,ui_scale 被直接忽略。
- 必须在用户设置中显式添加:
"dpi_awareness": "per_monitor_v2" -
ui_scale值建议与系统显示缩放比例一致(如系统设 150%,这里就填1.5) - 两项必须共存,顺序无关,但缺一不可
- 改完保存即生效,无需重启 Sublime
macOS 和 Linux 的处理逻辑完全不同
macOS Retina 屏原生支持高分屏渲染,Sublime Text 不需要任何 DPI 配置就能清晰显示,ui_scale 可选但非必需;Linux 则完全交给桌面环境(GNOME/KDE)的缩放设置驱动,Sublime 自身不干预 DPI 感知。
- macOS 用户只需关注
ui_scale或font_size,不用碰dpi_awareness - Linux 用户若发现模糊,应先检查系统级缩放是否启用(如 GNOME 的
gsettings set org.gnome.desktop.interface scaling-factor 2) - 所有平台都建议搭配
"font_options": ["no_antialias"]提升小字号锐度,尤其 macOS 上偶数font_size更稳
侧边栏、标签页、状态栏缩放不一致?别只调 font_size
单独改 font_size 只影响编辑区文字大小,侧边栏、标签页高度、图标尺寸仍会显得过小或错位。真正统一缩放 UI 元素的是 ui_scale,它从 Sublime Text 4(build 4126+)起全面支持。
-
ui_scale控制菜单、侧边栏、标签页、右键菜单等所有 UI 组件的整体比例 - 值推荐用 1.0 / 1.25 / 1.5 / 2.0 这类标准倍率,避免填 1.33 或 1.7 这类非整数倍导致渲染异常
- 若用了第三方主题(如 ayu、Material Theme),
ui_scale仍有效,但部分自定义控件可能需额外适配 - 和
font_size同时存在时,ui_scale优先影响 UI 尺寸,font_size仅覆盖编辑区字体
最容易被忽略的是:高分屏下 ui_scale 和 dpi_awareness 是绑定生效的,不是“开了就清晰”,而是“两个开关必须一起拨”。Windows 用户常卡在只设前者,结果界面照旧糊成一片。











