必须设为"opengl"(Win/Linux)或"metal"(macOS),写true、on等无效;需配合gpu_window_buffer:true并重启,再通过控制台日志验证出现OpenGL/Metal context created才真正启用。

怎么设 hardware_acceleration 才真正启用 GPU 渲染
Sublime Text 4 的 GPU 渲染不是“开了就生效”,hardware_acceleration 必须设为明确的字符串值,写 "true" 或 "on" 完全无效,会被静默忽略。Windows/Linux 用户应设为 "opengl",macOS(尤其 M 系列芯片)必须显式设为 "metal";想彻底禁用则设为 "none"。仅加 "gpu_window_buffer": true 不起作用——它只是辅助开关,没有后端指定,GPU 缓冲根本不会初始化。
验证是否真生效:打开控制台(View > Show Console),输入 sublime.log_commands(True),再滚动一个 50MB+ 日志文件。看到 OpenGL context created 或 Metal context created 才算成功;若出现 Failed to create OpenGL context,说明驱动缺失、被远程桌面劫持,或 Linux 下缺 libgl1-mesa-glx 等库。
为什么关掉 index_files 比开 GPU 更关键
GPU 加速只管界面绘制,不解决 CPU 和磁盘 I/O 瓶颈。哪怕 GPU 渲染已就位,只要 index_files 仍为 true,Sublime 就会在后台持续扫描项目文件、构建符号索引——百万行日志里光标一动就卡顿,就是这个原因。
必须在用户设置中加上:
{
"index_files": false,
"atomic_save": false,
"save_on_focus_lost": false
}
这些配置共同减少后台写入与索引压力。尤其 index_files,对纯查看大文件(如日志、dump 文件)场景,关闭后响应速度提升最直观。
font_options 配错会让 GPU 白开
字体渲染策略和系统不匹配时,GPU 绘制出来的文字照样发虚、泛绿边、边缘毛刺,用户会误以为“GPU 没起作用”,其实瓶颈已转移到文字光栅化层。
- Windows 高分屏:必须用
["directwrite"],并确保系统 ClearType 已完成校准;别混写["directwrite", "subpixel_antialias"],冲突后只生效第一个 - macOS Retina 屏:只认
["gray_antialias"],subpixel_antialias是雷区,会导致文字纤细无力、边缘发虚 - Linux 低分屏或 GNOME/KDE 默认环境:直接删掉
font_options字段最稳,乱填反而干扰 GTK/freetype 自主决策
改完必须完全退出 Sublime(菜单栏 → Sublime Text → 退出),热重载不触发渲染管线重初始化。
外接显示器卡顿别怪 Sublime,先查显卡输出链路
Sublime 在外接显示器上滚动撕裂、Tab 切换延迟,90% 是系统级问题:核显中转、EDID 报告异常、刷新率被系统过滤、DP 带宽不足。
Windows 用户应:
- 设备管理器中禁用 Intel/AMD 核显(仅保留独显)
- NVIDIA 控制面板 → 全局设置 → «首选图形处理器» 设为「高性能 NVIDIA 处理器」
- 关闭 Windows «快速启动»(电源选项 → 更改当前不可用的设置 → 取消勾选)
macOS 用户连接 DP 1.4 或 Thunderbolt 4 线缆后,在「系统设置 > 显示器」中悬停 «缩放» 按钮并按住 Option 键,调出隐藏的 «刷新率» 菜单,手动选 120Hz 或 HiDPI 模式。
GPU 渲染本身配置简单,但真正释放性能的前提是:系统图形栈就位、文件索引关闭、字体渲染策略对齐——漏掉任一环,都可能让优化效果归零。











