必须彻底杀掉所有sublime进程,否则缓存文件被锁住或状态不一致(如index数据库被lsp占用、cache残留socket),导致删后冷启动仍卡在“initializing”界面;需同步清理cache、index、local三处路径,并关闭index_files开关才能根治黑屏卡顿。

为什么清缓存前必须彻底杀掉所有 Sublime 进程
Sublime 启动黑屏几秒,常见于缓存文件被进程锁住或状态不一致——比如 Index 目录里的 SQLite 数据库正被 LSP 插件(如 pyright)占用,Cache 里残留的 socket 文件未关闭。此时哪怕你删了目录,Sublime 冷启动时仍会尝试读取损坏/锁定的旧状态,直接卡在“Initializing”界面不动。
务必先确认进程已完全退出:
- Windows:打开任务管理器,结束所有
sublime_text.exe和subl.exe - macOS:活动监视器中搜索
Sublime Text,强制退出全部实例 - Linux:运行
pkill -f "sublime_text"或pkill -f "subl"
漏掉任意一个残留进程,后续清理都可能白做。
必须清空的三个缓存路径,缺一不可
只删 Cache 是最常见误区。真正导致黑屏卡顿的是三类缓存叠加失效:Cache 存插件运行时产物(如 pyright 的类型缓存),Index 存全文搜索和跳转的底层数据库,Local 存 UI 状态快照(窗口布局、折叠树)。它们分散在不同位置,且部分路径系统级独占。
对应路径(删整个文件夹,别只删子目录):
- Windows:
%APPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Cache、%APPDATA%\Sublime Text\Local\Index - macOS:
~/Library/Application Support/Sublime Text/Cache、~/Library/Caches/Sublime Text、~/Library/Application Support/Sublime Text/Local/Index - Linux:
~/.config/sublime-text/Cache、~/.cache/sublime-text、~/.config/sublime-text/Local/Index
删完首次启动稍慢是正常的——它在重建干净的缓存,但不会再加载旧索引或卡死在初始化阶段。
插件卸载后缓存还在?重点扫 Packages/User 和 Cache 子目录
用 Package Control: Remove Package 卸载插件,只删代码不删状态。比如卸载 LSP-pyright 后,它的缓存仍藏在 Cache/pyright/ 下;右键菜单里残留的 “Format with Black” 很可能是 Packages/User/Black.sublime-settings 没清干净。
检查并清理这些地方:
-
Packages/User/下所有以插件名命名的.sublime-settings或.sublime-commands文件 -
Cache/下与插件同名的子文件夹(如pyright、texlab、GitGutter) -
Installed Packages/中残留的PluginName.sublime-package(尤其曾多次装/卸的插件)
重启后按 Ctrl+Shift+P 输入命令名,如果还能搜到已卸载插件的入口,说明上面某处没清干净。
index_files 开关比清缓存还关键
默认开启的 index_files 是黑屏卡顿头号原因。它会在启动时扫描整个项目建符号索引,遇到 node_modules 这种几万文件的目录,光是遍历 stat() 就能卡主线程数秒,尤其在 macOS 的 FSEvents 或老旧 SSD 上更明显。
进 Preferences → Settings,在右侧用户设置中加这一行:
"index_files": false
副作用明确:Ctrl+R 跳函数定义、Ctrl+Click 跳转、Find All References 全部失效;但 Ctrl+P 按文件名搜索、Ctrl+Shift+F 全局文本搜索仍可用。若需折中,改用项目级排除:Project → Edit Project 中加 "folder_exclude_patterns": ["node_modules", ".git"],用户设置里写无效。
这个配置不清理缓存也生效,但和缓存清理配合使用,才能彻底解决黑屏几秒的问题——因为旧索引数据本身就会触发校验逻辑,哪怕 index_files 关了,残留的损坏 Index 目录仍可能拖慢初始化流程。











