闪退没日志时，先试subl --no-gpu启动；若不再闪退，说明是GPU渲染路径崩溃，需禁用硬件加速并彻底退出进程验证。
闪退没日志？先试 --no-gpu 启动
Sublime Text 4 渲染超大文件或含特殊 Unicode 字符时直接退出，连控制台都来不及弹出，大概率是 GPU 渲染路径崩了。这不是内存不够，而是 OpenGL 上下文在某些集成显卡（如 Intel HD 4000、AMD R5 M230）或旧驱动上被强制终止。
最快速验证方式：终端执行 subl --no-gpu /path/to/file。如果不再闪退，说明问题锁定在 GPU 加速层。
- Windows 用户可进一步关闭 DWM：任务管理器 → 性能 → GPU → 图形设置 → 添加
sublime_text.exe→ 设为“省电”模式 - macOS 用户运行
defaults write com.sublimetext.4 "gpu_window_buffer" -bool false，然后彻底重启 Sublime - 别只改设置，必须完全退出进程（检查任务管理器/活动监视器里是否还有残留
subl或Sublime Text进程）
控制台报错堆栈顶行才是真线索
弹窗显示 “plugin_host has exited unexpectedly” 是结果，不是原因。真正线索藏在控制台（Ctrl + `）最顶行的 File "./Packages/XXX/xxx.py" —— 其中 XXX 就是问题插件名。
常见错误类型对应处理方向：
-
ImportError: cannot import name 'create_connection'→ 插件调用了 Sublime 嵌入 Python 不支持的标准库函数，需降级或换兼容版 - 含
ssl、urlopen、certifi的报错 → Package Control 网络层失败，和你装的插件无关，检查channelsURL 是否浏览器可访问 -
NoneType is not callable→ 插件主文件里某个回调（如on_activated）缺失或未定义
别扫一眼就关控制台——崩溃前往往已有十几次静默 AttributeError，顶行才是源头。
插件被静默屏蔽？查 ignored_packages
插件明明装了却不生效、命令面板搜不到、右键无菜单，大概率已被 Sublime 自动加入 ignored_packages 黑名单。这通常发生在签名异常、结构不全或 API 版本不匹配时。
验证方法：控制台输入 sublime.load_settings('Preferences.sublime-settings').get('ignored_packages')，回车看输出是否含你的插件名（如 "SideBarEnhancements"）。
- 编辑
Preferences.sublime-settings - User，找到"ignored_packages"行，从中删掉对应插件名（注意 JSON 格式，逗号不能丢） - 保存后必须彻底重启 Sublime，否则无效
- 插件文件夹名必须严格匹配原始仓库名：
emmylua_v2.0要改成emmylua，my plugin要改成myplugin
汉化失效或颜色方案不加载？路径和格式必须严丝合缝
汉化菜单回退英文、主题看起来像生效但实际没加载，90% 是路径或格式踩坑。Sublime 不报错，只静默回退到默认值。
颜色方案失败典型场景：
-
color_scheme值写成MyScheme.sublime-color-scheme，但文件实际在Packages/User/下 → 正确路径应为Packages/User/MyScheme.sublime-color-scheme - 把旧版
.tmTheme文件直接丢进 ST4 → ST4 只认.sublime-color-scheme（JSON 格式），XML 已彻底弃用 - macOS/Linux 下文件名大小写不一致（
ayu-dark.sublime-color-scheme≠Ayu-Dark.sublime-color-scheme）
汉化包冲突更隐蔽：检查 Installed Packages/ 目录是否同时存在 ChineseLocalization.sublime-package 和魔改版 Default.sublime-package —— 只保留一个最新版，其余全删。删完还要清空 Cache/ 目录，否则旧翻译索引仍会干扰。
