sublime text启动慢的真凶是插件、index_files索引和残留session;通过安全模式确认问题后,禁用高危插件、关闭index_files、清除session.sublime_session及cache/local/index三处缓存可将启动压至0.8秒。

Sublime Text 启动慢,基本不是编辑器本身的问题,而是它在冷启动时被迫加载了三类东西:插件、index_files 全项目索引、残留的 Session.sublime_session。这三项叠加,能把本该毫秒级的启动拖到 5–8 秒;清掉它们,0.8 秒内响应很常见。
怎么确认是插件拖慢了启动
别靠感觉猜。关掉所有 Sublime 实例,按住 Ctrl(Windows/Linux)或 Cmd(macOS)再双击图标启动——这是安全模式,跳过全部插件、不读用户设置、不恢复窗口。如果秒开,问题就 100% 出在你的插件或配置里。
接着做两件事:
- 按
Ctrl+Shift+P输入Package Control: List Packages,重点看两年没更新的:比如SublimeCodeIntel、GitGutter v1.x、AutoFileName - 按
Ctrl+`打开控制台,扫一眼有没有红色报错:ImportError、timeout、unresolved import——出现这些的插件,基本就是卡顿元凶
为什么关掉 index_files 效果最立竿见影
index_files 是默认开启的全项目符号索引功能,启动时会遍历整个项目目录(包括 node_modules、.git、dist),对每个文件做 stat() 系统调用。遇到几万文件的目录,主线程直接卡死,尤其在 macOS 和 Windows 上感知极强。
进 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", "__pycache__"]
哪些缓存和配置容易被忽略
长期使用后,Session.sublime_session 和 Index/ 缓存目录会悄悄膨胀,变成隐形性能杀手。它们不像插件那样显眼,但不清理,优化效果直接打五折。
操作前务必先彻底退出 Sublime(否则文件被占用删不掉):
- Windows 路径:
%APPDATA%\Sublime Text 3\Local\,删掉Session.sublime_session和整个Index/目录 - macOS 路径:
~/Library/Application Support/Sublime Text 3/Local/,同上 - Linux 路径:
~/.config/sublime-text/Local/,同上
顺手清空三处缓存路径(缺一不可):Cache、Caches、Local\Index —— 不只删 Cache 目录是常见误区,Index 才是 LSP 卡死、跳转失败的根源。
禁用比卸载更稳妥,但卸载后必须清残留
禁用插件用 Preferences → Package Control → Disable Package,重启即生效;配置和快捷键全留着,回滚成本几乎为零。
但如果你已用 Package Control: Remove Package 卸载过插件,注意它只删了 Packages/GitGutter/ 和 Installed Packages/GitGutter.sublime-package,以下三处还留着:
-
Packages/User/GitGutter.sublime-settings—— 配置残留会让 Sublime 启动时仍尝试加载逻辑 -
Cache/下以插件名命名的子文件夹(如pyright、texlab)—— 存的是语言服务器索引、socket 文件,损坏后 CPU 持续 100% -
Local/中可能存在的状态快照(如折叠树、右键菜单注册项)—— 导致菜单错位、命令面板还能调出已卸载插件入口
检查方法:重启后按 Ctrl+Shift+P 输入 Format with Black,如果还能看到,说明 Black.sublime-settings 或对应缓存没清干净。











