必须通过控制台日志与行为交叉验证：打开控制台输入sublime.log_commands(True)，滚动50MB大文件，出现“OpenGL context created”（Win/Linux）或“Metal context created”（macOS）才成功；否则为静默回退CPU渲染。
Sublime Text 4 开启 GPU 加速后黑屏或闪烁，不是配置没开对，而是显卡驱动与 OpenGL/Metal 上下文创建失败——必须验证上下文是否真建立，且后端必须匹配硬件，否则直接 fallback 到软件渲染却无提示。
如何确认 Sublime Text 4 是否真正启用了 GPU 渲染
Sublime 不会弹窗告诉你 GPU 是否生效，改完 hardware_acceleration 后不验证等于白改。关键看控制台日志和行为反馈：
- 打开控制台（
Ctrl+`），输入sublime.log_commands(True) - 滚动一个真实大文件（比如 50MB 的日志或
node_modules里的长 JS 文件） - 观察控制台输出：
OpenGL context created（Windows/Linux）或Metal context created（macOS）才表示成功；若出现Failed to create OpenGL context或software rendering fallback，说明 GPU 渲染已静默失效，界面仍在用 CPU 软件光栅化
hardware_acceleration 配置值写错就完全无效
这个字段只接受特定字符串，写 true、"on"、1 或留空都无效，Sublime 会直接忽略整行：
- Windows / Linux：必须设为
"hardware_acceleration": "opengl"（默认值，但不保证实际生效） - macOS（尤其 M 系列芯片）：必须显式设为
"hardware_acceleration": "metal"，删掉该行不会自动恢复 - 彻底禁用：设为
"hardware_acceleration": "none"，不是"off"或false - 别和
"gpu_window_buffer": true混淆——它只是辅助开关，没指定后端，GPU 缓冲根本不会初始化
开了 GPU 还黑屏/闪烁？大概率是驱动或后端不匹配
GPU 加速开启后仍异常，往往不是 Sublime 问题，而是底层图形栈冲突：
- Intel HD Graphics 620/630 用户常见
Failed to create OpenGL context：换用"hardware_acceleration": "none"或升级 Intel 显卡驱动至 31.0.101.5185 及以上（WHQL 认证版） - macOS Sonoma + M3 芯片上启用
"opengl"会黑屏：必须强制用"metal"，且确保系统未启用 Rosetta（右键 App → “显示简介” → 取消勾选“使用 Rosetta”） - Linux 下 Mesa 驱动未启用
iris后端时，glxinfo | grep "OpenGL renderer"显示 llvmpipe：此时"opengl"实际走的是 CPU 软件渲染，但 Sublime 不报错，需改用"none"或更新 Mesa 至 24.1+ - 某些 NVIDIA 笔记本（Optimus 架构）默认用集显运行 Sublime，导致 OpenGL 上下文创建失败：需在 NVIDIA 控制面板中将
sublime_text可执行文件手动指定为“高性能 NVIDIA 处理器”
黑屏后连控制台都打不开？用安全模式绕过配置加载
如果启动即黑屏，无法进入界面调出控制台，说明 GPU 初始化阶段已崩溃。此时需跳过用户配置强制启动：
- Windows：命令行运行
subl --safe-mode（确保已添加到 PATH） - macOS：终端执行
/Applications/Sublime\ Text.app/Contents/MacOS/Sublime\ Text --safe-mode - Linux：运行
subl --safe-mode或./sublime_text --safe-mode（取决于安装路径） - 安全模式下所有插件和用户设置被禁用，若此时能正常显示，说明问题出在
Preferences.sublime-settings或某个插件干扰了 GPU 上下文创建
真正麻烦的不是参数怎么写，而是显卡驱动对 OpenGL/Metal 的实现质量参差不齐——同一块 Intel 核显，在 Windows 上可能创建 OpenGL 成功，在 Linux Mesa 下却 fallback 到 llvmpipe 却不报错。验证必须靠日志，不能靠设置里写了什么。
