windows下ui_scale单独设置无效,必须先右键快捷方式→兼容性→勾选“替代高dpi缩放行为”并选“应用程序”,再配合"dpi_awareness":"per_monitor_v2"与"ui_scale":1.5等值成对配置,且需完全退出后重启;macos原生支持可直用ui_scale,linux依赖系统缩放。

ui_scale 单独设置无效,必须搭配 dpi_awareness 才能真正启用高分屏缩放逻辑;Windows 下不走兼容性设置强制接管 DPI 行为,后续所有配置都白调。
Windows 必须先设「替代高DPI缩放行为」为应用程序
Sublime Text 不支持 Windows 的 Per-Monitor DPI 动态切换,默认被系统当成“未适配应用”整体拉伸。光改 Preferences.sublime-settings 没用,第一步永远是让系统放手:
- 右键 Sublime 快捷方式 → 属性 → 兼容性 → 「更改高 DPI 设置」
- 勾选「替代高 DPI 缩放行为」,下拉选「应用程序」
- 必须完全退出 Sublime(托盘右键 → Exit)再重启,热重载不重建 DPI 上下文
这步跳过,ui_scale 和 dpi_awareness 都不会生效——系统还在强行位图缩放整个窗口。
ui_scale 和 dpi_awareness 要成对出现且值严格匹配
只写 "ui_scale": 1.5 是常见失败原因。Windows 下 dpi_awareness 必须显式设为 "per_monitor_v2",否则仍走系统默认的 unaware 模式:
{
"ui_scale": 1.5,
"dpi_awareness": "per_monitor_v2",
"font_options": ["directwrite"]
}
-
ui_scale值必须对应你常用屏幕的缩放百分比(150% →1.5,200% →2.0),不能填字符串或整数 -
dpi_awareness只接受"per_monitor_v2",填"system"或留空等于没设 -
font_options必须是数组,不是字符串;加["directwrite"]是为中文字体防虚前提
侧边栏和标签页字体不随 ui_scale 变?主题没重写字号
ui_scale 只缩放按钮、菜单栏、状态栏高度等容器尺寸,文件名、标签文字大小由主题控制——这是最常被忽略的“缩放成功但字还是小”的根源:
- 新建
Packages/User/Adaptive.sublime-theme(若当前用 Adaptive 主题) - 写入:
[{"class":"sidebar_label","font.size": 14},{"class":"tab_label","font.size": 13}] - 按
Ctrl+Shift+P→ 输入UI: Reload Theme生效 - 别改
Default.sublime-theme,它会被更新覆盖
即使 ui_scale 对了,侧边栏字体仍小,不是缩放失效,是主题没声明字号。
macOS 和 Linux 的关键差异点
macOS 原生支持 HiDPI,ui_scale 可直接生效,但必须删掉主题里偷偷写的 "no_antialias" ——很多主题(如 ayu、Material Theme)在 .sublime-theme 里加了这一行,等于主动关掉亚像素渲染,光标和文字全变锯齿块。
- 检查当前主题文件,删掉所有
"no_antialias"相关项 - Linux 下依赖 GTK/Qt 缩放设置,
ui_scale通常有效,但若字体发虚,优先查系统级gsettings set org.gnome.settings-daemon.plugins.xrandr dpi-scale-factor或 Qt 环境变量
真正卡住的地方,往往是改完配置没彻底退出 Sublime,或者以为 ui_scale 能管一切,却忘了主题层根本没响应它。











