闪退只发生在特定项目，根源在于.project文件配置错误、插件监听崩溃、硬件加速冲突或Session.sublime_session损坏，需按四维度交叉排查。
闪退只发生在特定项目，先查 project 文件和路径
项目级闪退几乎都跟 .sublime-project 或文件夹路径有关，不是全局配置问题。Sublime 在加载项目时会解析 JSON 配置、扫描路径、触发插件监听逻辑，任一环节出错都会导致进程直接退出——连控制台都来不及弹出。
常见诱因包括：
-
.sublime-project中的folders字段含非法字符（如未转义的反斜杠、中文路径、空格未引号包裹） -
settings里写了 Sublime 不支持的键（如font_size设为字符串而非数字） - 项目根目录下存在损坏的
.sublime-workspace文件，尤其在强制杀进程后残留 - 路径中包含符号链接（symlink），而某些插件（如 GitSavvy、SideBarEnhancements）在遍历时触发底层异常
实操建议：
- 临时重命名当前项目的
.sublime-project和.sublime-workspace，再打开项目看是否还闪退 - 若正常，用 VS Code 打开原
.sublime-project，用 JSON 校验工具（如 jsonlint.com）检查语法 - 路径含中文？把项目移到纯 ASCII 路径下测试（例如
D:projmyapp），确认后再考虑 Unicode 转义 - Windows 下注意路径分隔符：JSON 中必须用
/或双反斜杠\，单个是转义符，会导致解析失败
插件监听项目加载时崩溃，重点排查 Git / 文件索引类插件
很多插件会在 on_project_load 或 on_activated 事件中执行同步 IO 操作（比如读取 .git/config、扫描 node_modules），一旦路径不存在、权限不足或返回空值，就可能引发 NoneType is not callable 或 FileNotFoundError，最终拖垮整个 plugin_host 进程。
典型高危插件：
-
GitGutter：项目无 .git 目录时尝试调用 git 命令失败 -
SideBarEnhancements（v3.0.0 之前）：对空folders数组做迭代崩溃 -
SublimeLinter+eslint：找不到node_modules/.bin/eslint时抛异常而非静默降级
实操建议：
- 关闭 Sublime，进入
%APPDATA%Sublime TextPackages（Windows）或~/Library/Application Support/Sublime Text/Packages/（macOS），对上述插件文件夹重命名为GitGutter_bak等 - 重启并打开该问题项目，确认是否稳定；若稳定，再逐个恢复插件名并重启，定位具体插件
- 找到问题插件后，不要急着卸载——先查其 GitHub Issues，搜索关键词 “project load crash” 或版本号，常有已知修复补丁
- 临时规避：在项目
.sublime-project的settings中加"ignored_packages": ["GitGutter"]，比全局禁用更精准
硬件加速与高 DPI 缩放共同触发闪退，Windows 用户必试
Windows 上 Sublime Text 4 在 125%+ 缩放 + hardware_acceleration 启用状态下，启动特定项目时偶发 GPU 渲染线程死锁，表现为进程创建后 200ms 内消失，任务管理器里 sublime_text.exe 存在时间极短，且无任何日志输出。这不是插件问题，是底层渲染管线冲突。
验证方式：以命令行启动并附加参数
subl --no-hardware --safe-mode "D:yourproject older"
如果此时能稳定打开，基本锁定是渲染层问题。
实操建议：
- 打开
Preferences → Settings，在右侧用户设置中添加："hardware_acceleration": "none" - 不要写
false或"off"，只有"none"是有效值 - 若使用多显示器且缩放比例不一致，还需加：
"ui_scale": 1.0（强制 UI 缩放为 1:1） - 改完保存，**必须完全退出 Sublime（右键托盘图标 → Exit）再重新启动**，仅重启窗口无效
Session.sublime_session 损坏导致项目加载失败
当 Sublime 异常退出（如断电、强制 kill）时，Session.sublime_session 可能写到一半就中断，变成半截 JSON。下次启动时若恰好加载该会话对应项目，解析失败会直接终止进程——你甚至看不到错误提示，因为解析发生在 GUI 初始化前。
这个文件位于：
- Windows：
%APPDATA%Sublime TextLocalSession.sublime_session - macOS：
~/Library/Application Support/Sublime Text/Local/Session.sublime_session - Linux：
~/.config/sublime-text/Local/Session.sublime_session
实操建议：
- 关闭 Sublime Text（确保所有进程结束）
- 重命名
Session.sublime_session为Session.sublime_session.bak - 启动 Sublime，用菜单
Project → Open Project…重新加载该文件夹（不要双击项目文件） - 若成功，说明原 session 损坏；可手动从备份文件中提取未保存内容（搜
"buffers"字段） - 长期预防：在设置中关掉
"hot_exit": false，避免 session 文件频繁写入
真正麻烦的不是闪退本身，而是它发生时往往不报错、不留痕——你得从项目结构、插件行为、系统缩放、会话文件这四个维度交叉验证，漏掉任何一个，都可能反复踩进同一个坑。
