必须同步清理Cache、Index、Local三目录并彻底退出进程,因Index存全文搜索与符号跳转数据库,损坏会导致CPU飙升、Goto Definition失效;只删Cache无效,且未退出进程会导致文件被锁、清理失败。

Sublime Text 卡顿、CPU 暴涨、Goto Definition 失效,基本不是硬件或系统问题,而是缓存和索引没清对位置、没杀干净进程导致的——删错目录、漏删 Index、或者边运行边删,90% 的“清理”都白做了。
为什么只删 Cache 目录不管用
因为真正拖慢 Sublime 的是 Index 文件夹,不是 Cache。它存的是全文搜索、符号跳转(Ctrl+P、Ctrl+R、Ctrl+Click)的底层数据库,体积大、易损坏、且不随 Cache 一起重建。
-
Cache只存临时编译结果和插件运行时数据,删了安全,重启自动生成 -
Index一旦损坏,就会出现“搜得到函数名但点不进去”“项目一打开 CPU 就 100%” - Windows 和 macOS 上常有两个
Cache路径并存,只清一个等于漏一半 - 别误删
Index Files或Indexing—— 就找纯叫Index的文件夹,整目录删
必须先彻底退出进程,否则删不干净
Sublime Text 4 默认后台常驻:窗口关了 ≠ 进程退出。文件被锁住,删一半就中断,或者删完立刻被写回旧数据。
- Windows:任务管理器里搜
sublime_text.exe和subl.exe,全部“结束任务” - macOS:活动监视器中搜
Sublime Text,强制退出所有匹配项(包括com.sublimetext.4) - Linux:终端执行
pkill -f "sublime_text"或pkill -f "subl" - 右下角托盘图标右键选
Exit不够,必须确认进程列表为空
插件卸载后还在吃 CPU?查这三处残留
Package Control 的 Remove Package 只删主代码,不碰配置、缓存、状态。像 pyright、texlab 这类 LSP 插件,卸载后仍可能拉起后台进程。
-
Packages/User/下删配置文件:LSP-pyright.sublime-settings、GitGutter.sublime-settings,空文件也要删 -
Cache/中按插件名搜索(如pyright、anaconda),整文件夹删除 -
Local/可直接删:它只存窗口布局、折叠状态、崩溃快照,重启自动生成;但长期不清理会导致启动卡顿、主题加载失败
删完重启还卡?重点检查 index_files 和 State
很多人清完 Cache 和 Index 就停手,却忽略了两个隐藏性能杀手:
-
"index_files": false必须加进用户设置(Preferences → Settings),否则打开含node_modules的项目,它会递归扫描上万文件,主线程直接卡死 -
State文件夹(在Local/内)存 UI 状态:侧边栏展开项、标签页顺序、折叠区域。碎片化后会造成菜单错位、主题失效、频繁崩溃 - 若启动异常,可临时重命名
Local/State为State.bak,观察是否恢复
真正有效的清理,从来不是删得越多越好,而是删对位置、避开 Session 和 Packages 这类不能动的目录,同时盯紧那些名字普通但作用关键的文件夹——比如就叫 Index,就叫 State,就叫 pyright。


















