Sublime启动慢等问题90%源于缓存与索引未清干净;需彻底退出进程后,同步删除Cache、Index、Local三处路径,并禁用index_files防复发。

Sublime Text 启动慢、卡顿、右键菜单残留、Goto Definition 失效,90% 不是编辑器本身的问题,而是缓存和索引没清干净——删错位置、删不全、进程没杀干净,都白忙。
怎么确认是缓存/索引导致卡顿?用安全模式验证最准
关掉所有 Sublime 实例后,按住 Ctrl(Windows/Linux)或 Cmd(macOS)再双击图标启动,这就是安全模式:不加载插件、不读用户设置、不恢复窗口。如果秒开,问题 100% 出在你的缓存、索引或插件残留上。
安全模式下立刻按 Ctrl+` 打开控制台,扫一眼有没有红色报错:ImportError: No module named 'requests'、timeout waiting for git status、unresolved import sublime_plugin——这些基本指向已损坏或未卸载干净的插件。
必须清空的三个路径:Cache、Index、Local,缺一不可
只删 Cache 是最常见误区。真正拖慢启动、让 Ctrl+R 失效、CPU 持续 100% 的,是分散在三处的缓存叠加失效:
-
Cache:存插件运行时产物(如pyright的类型缓存、LSP socket 文件) -
Index:全文搜索和符号跳转的底层数据库(不是index_files设置项,就是纯叫Index的文件夹) -
Local:UI 状态快照(窗口布局、折叠树、崩溃恢复点),长期不清理会导致菜单错位、启动黑屏
操作前务必先彻底退出 Sublime:
Windows:任务管理器搜 sublime_text.exe 和 subl.exe,全部结束;
macOS:活动监视器搜 Sublime Text,强制退出所有匹配项;
Linux:终端执行 pkill -f "sublime_text" 或 pkill -f "subl"。
删哪些具体路径?按系统对号入座
注意:Sublime Text 4 的路径名里不含数字(如 Sublime Text),别误删 Sublime Text 3 目录。
Windows:%APPDATA%\Sublime Text\Cache%LOCALAPPDATA%\Sublime Text\Cache%APPDATA%\Sublime Text\Local\Index%LOCALAPPDATA%\Sublime Text\Local\Index
macOS:~/Library/Application Support/Sublime Text/Cache~/Library/Caches/Sublime Text~/Library/Application Support/Sublime Text/Local/Index~/Library/Saved Application State/com.sublimetext.4/(删含插件关键词的子目录)
Linux:~/.config/sublime-text/Cache~/.cache/sublime-text~/.config/sublime-text/Local/Index
插件卸载后还在吃 CPU?重点清 Packages/User 和 Cache 下的同名残留
Package Control: Remove Package 只删主代码和 .sublime-package,对以下三处完全不管:
-
Packages/User/下的配置文件:LSP-pyright.sublime-settings、GitGutter.sublime-settings、Default (Windows).sublime-keymap(搜"command": "git_gutter"整块删) -
Cache/下以插件名命名的子文件夹:Windows 进%LOCALAPPDATA%\Sublime Text\Cache\搜pyright,整文件夹删除;Linux/macOS 同理 - 同步状态没登出:
subl --sync-logout必须执行,否则重装后所有设置和插件会从云端自动拉回
删完重启前,建议在 Preferences → Settings 用户设置中加一行:"index_files": false。它不能替代清理,但能防复发——尤其当你常开含 node_modules 的项目时,这是立竿见影的止痛针。



















