Sublime启动慢主因是插件加载、index_files扫描和残留会话;用安全模式(Ctrl/Cmd+双击)验证,若秒开则问题100%出在插件或配置,再查控制台报错、禁用高危插件、设"index_files": false并清空Cache/Inde/Local三处缓存。

Sublime 启动慢,90% 以上不是编辑器本身的问题,而是插件加载、index_files 扫描和残留会话三者在启动时同步阻塞主线程——改对地方,冷启动能从 5 秒压到 0.8 秒。
怎么确认是插件拖慢了启动?用安全模式实测最准
关掉所有 Sublime 实例后,按住 Ctrl(Windows/Linux)或 Cmd(macOS)再双击图标启动,这就是安全模式:不加载任何插件、不读用户设置、不恢复窗口。如果秒开,问题 100% 出在你的插件或自定义配置上。
- 安全模式下立刻按
Ctrl+`打开控制台,扫一眼有没有红色报错:ImportError: No module named 'requests'、timeout waiting for git status、unresolved import sublime_plugin——这些对应插件基本就是元凶 - 打开命令面板
Ctrl+Shift+P,输入Package Control: List Packages,重点排查两年没更新的插件,比如SublimeCodeIntel、GitGutter v1.x、AutoFileName - 禁用比卸载更稳妥:进
Preferences → Package Control → Disable Package,选中后重启即生效;配置和快捷键全保留,回滚成本几乎为零
为什么关掉 index_files 效果最立竿见影?
index_files 是 Sublime 默认开启的全项目符号索引功能。它会在启动时递归扫描整个项目目录(包括 node_modules、.git、dist),构建跳转和搜索数据库。遇到几万文件的目录,光是 stat() 系统调用就足以卡死主线程。
- 进
Preferences → Settings,在右侧用户设置中加一行:"index_files": false,必须完全退出 Sublime(不是重载设置),再重启才生效 - 副作用明确:
Ctrl+R跳函数定义、Ctrl+Click跳转、Find All References全部失效;但Ctrl+P(按文件名搜索)、Ctrl+Shift+F(全局文本搜索)仍可用 - 若仍需部分索引能力,不要全局关死,改用项目级排除:在
Project → Edit Project中加"folder_exclude_patterns": ["node_modules", ".git", "dist"]
必须清空的三个缓存路径,缺一不可
只删 Cache 是最常见误区。真正导致黑屏卡顿的是三类缓存叠加失效:Cache 存插件运行时产物(如 pyright 的类型缓存),Index 存全文搜索和跳转的底层数据库,Local 存 UI 状态快照(窗口布局、折叠树)。它们分散在不同位置,且部分路径系统级独占。
- 务必先彻底杀掉所有 Sublime 进程,否则缓存文件被锁住或状态不一致(比如
Index数据库正被 LSP 插件占用、Cache里残留 socket 文件未关闭),删后冷启动仍卡在 “Initializing” 界面 - 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(尤其曾多次装/卸的) - macOS 用户额外注意:
~/Library/Saved Application State/com.sublimetext.4/也藏插件状态,删含关键词的子目录
最容易被忽略的是进程没杀干净——哪怕漏掉一个 subl.exe 或后台 pyright 进程,删完的缓存目录可能立刻被写回旧状态,所有操作白做。动手前务必用任务管理器、活动监视器或 pkill -f "sublime_text" 确认进程列表为空。

















