确认插件拖慢启动需用安全模式实测:关掉所有实例后按住Ctrl/Cmd双击启动,若秒开则问题必在插件或配置;再按Ctrl+`查控制台红色报错(ImportError、timeout、unresolved import),对应插件即卡顿元凶。

怎么确认是插件在拖慢启动
别靠猜,用安全模式实测最准:关掉所有 Sublime 实例,按住 Ctrl(Windows/Linux)或 Cmd(macOS)再双击图标启动。这时跳过全部插件、不读用户设置、不恢复窗口。如果秒开,问题就 100% 出在你的插件或配置上。
进安全模式后,按 Ctrl+` 打开控制台,扫一眼有没有红色报错:
-
ImportError:比如No module named 'requests',说明插件依赖缺失 -
timeout:常见于GitGutter、SublimeLinter等调用外部命令的插件 -
unresolved import:多见于老旧插件(如SublimeCodeIntel、GitGutter v1.x)与新版 Sublime 不兼容
这些报错对应的插件,基本就是卡顿元凶。
哪些插件该优先禁用而非卸载
禁用比卸载更稳妥——保留配置、快捷键和命令面板入口,回滚成本几乎为零。Preferences → Package Control → Disable Package,选中后重启即生效。
以下几类插件启动时就阻塞主线程,或持续轮询监听,CPU 和内存双高:
-
GitGutter(尤其 v1.x):Windows 上因ReadDirectoryChangesW频繁重扫,大仓库直接卡死 -
sublime-lsp、pylsp等 LSP 客户端:默认全项目加载,Python/Java 大项目一开就后台分析 -
SideBarEnhancements:右键菜单初始化耗资源,尤其在含node_modules的根目录下 -
AutoFileName、All Autocomplete:启动即加载全部文件路径,遇到几十万文件的目录直接卡住
禁用前可先查 Package Control: List Packages,重点看两年没更新的:比如 SublimeCodeIntel、GitGutter v1.x、AutoFileName。
为什么关 index_files 效果最立竿见影
index_files 是 Sublime 默认开启的全项目符号索引功能,启动时会遍历整个项目目录(包括 node_modules、.git、dist),对每个文件做 stat() 系统调用。遇到几万文件的目录,主线程直接卡死,尤其在 macOS 和 Windows 10/11 上感知极强。
进 Preferences → Settings,在右侧用户设置里加这一行:
"index_files": false
副作用明确:Ctrl+R(跳函数定义)、Ctrl+Click(跳转)、Find All References 全部失效;但 Ctrl+P(按文件名搜索)、Ctrl+Shift+F(全局文本搜索)仍可用。
若仍需部分索引能力,别直接关死,改用排除策略:
"folder_exclude_patterns": ["node_modules", ".git", "__pycache__"]
清理插件残留比禁用更重要
只禁用或卸载插件远远不够。Package Control: Remove Package 只删插件本体(Packages/GitGutter/)和 Installed Packages/GitGutter.sublime-package,但以下三处全留着:
-
Packages/User/GitGutter.sublime-settings:配置残留会让 Sublime 启动时仍加载相关逻辑 -
Cache/下以插件名命名的子文件夹(如pyright、texlab):存的是语言服务器索引、socket 文件、编译缓存,损坏后 CPU 持续 100% -
Local/中可能存在的状态快照(如折叠树、右键菜单注册项):导致菜单错位、命令面板里还能调出已卸载插件的入口
必须清空的三个缓存路径,缺一不可(操作前务必彻底退出 Sublime):
- 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
删完首次启动稍慢是正常的——它在重建基础缓存,但不会再加载旧索引。


















