快速确认插件拖慢启动:关所有实例后按住Ctrl(Win/Linux)或Cmd(macOS)双击启动进入安全模式,若秒开则问题100%出在插件或配置;进安全模式后按Ctrl+`看控制台红色报错,如ImportError、timeout或unresolved import可锁定问题插件。

怎么快速确认是不是插件拖慢了启动
关掉所有 Sublime 实例后,按住 Ctrl(Windows/Linux)或 Cmd(macOS)再双击图标启动——这就是安全模式:不加载任何插件、不读用户设置、不恢复窗口。如果秒开,问题 100% 出在你的插件或自定义配置上。
进安全模式后立刻按 Ctrl+` 打开控制台,扫一眼有没有红色报错:
-
ImportError: No module named 'requests'→ 对应插件依赖缺失,大概率是老旧插件 -
timeout waiting for git status→ GitGutter 或 SublimeLinter 类插件卡在外部命令调用 -
unresolved import sublime_plugin→ 插件与当前 Sublime 版本不兼容,常见于 SublimeCodeIntel、GitGutter v1.x
打开命令面板 Ctrl+Shift+P,输入 Package Control: List Packages,重点排查两年没更新的插件。禁用比卸载更稳妥:Preferences → Package Control → Disable Package,选中后重启即生效,配置和快捷键全保留。
为什么关掉 index_files 效果最立竿见影
index_files 是 Sublime 默认开启的全项目符号索引功能,启动时会递归扫描整个项目目录(包括 node_modules、.git、dist),构建跳转和搜索数据库。遇到几万文件的目录,光是 stat() 系统调用就足以卡死主线程——尤其在 WSL2 的 /mnt/c/ 路径下,每次调用延迟高达 300–500ms。
进 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", "__pycache__"]
必须清空的三个缓存路径,缺一不可
只删 Cache 是最常见误区。真正导致黑屏卡顿的是三类缓存叠加失效:
-
Cache:存插件运行时产物(如 pyright 的类型缓存) -
Index:存全文搜索和跳转的底层数据库(不是 “Index Files”,就是纯叫Index的文件夹) -
Local:存 UI 状态快照(窗口布局、折叠树、Session.sublime_session)
务必先彻底杀掉所有 Sublime 进程(Windows 任务管理器搜 sublime_text.exe 和 subl.exe;macOS 活动监视器强制退出;Linux 执行 pkill -f "sublime_text"),否则缓存文件被锁住或状态不一致。
删哪几个目录?三处路径都要清:
- Windows:
%APPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Local\Index、%APPDATA%\Sublime Text\Local\Session.sublime_session - 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
哪些插件最常在启动时卡死主线程
不是所有插件都平等。以下几类在 plugin_loaded() 阶段就做同步 I/O 或调外部命令,一启动就锁死界面:
-
Package Control:默认开启自动升级,每次启动都尝试连 GitHub,国内网络下常卡在超时等待;可在Preferences → Package Settings → Package Control → Settings – User中加"auto_upgrade": false -
GitGutter(尤其 v1.x):Windows 上依赖ReadDirectoryChangesW,大仓库或网络盘极易拖垮响应;可先尝试非阻塞模式:"non_blocking": true -
sublime-lsp/pylsp等 LSP 客户端:默认全项目加载,打开 Python/Java 大项目时后台持续分析;建议先禁用,再通过插件自身设置限定作用路径(如只对src/启用) -
SideBarEnhancements:右键菜单初始化耗资源,尤其在含数万文件的项目根目录下 - 任何带
sublime_plugin.EventListener且监听on_activated或on_load的插件,若内部有读配置、查网络等阻塞操作,都会拉长响应时间
插件卸载后还卡?重点清 Packages/User/ 下的残留配置(如 LSP-pyright.sublime-settings)和各 Cache 路径下对应插件名的子目录(如 Cache/pyright/)。这些残留不清理,CPU 照样 100%,跳转照样失效。











