Sublime Text 卡顿、CPU 飙高、右键菜单残留、Goto Definition 失效的根本原因是缓存和索引未彻底清理;必须手动清除三处路径(Cache、Local/Index、Packages/User 配置)、退出所有进程并登出同步账号,缺一不可。

Sublime Text 卡顿、CPU 持续飙高、右键菜单残留、Goto Definition 失效——根本不是硬件或版本问题,而是缓存和索引没清干净。手动删一次能管一周,但“自动清理”不存在于原生功能里;所谓“自动”,其实是靠你提前设好路径、关死进程、分三处精准清除,再配合同步登出,才能让每次重启都像刚装完一样轻快。
为什么 Package Control: Remove Package 卸载后还卡
它只删 Packages/GitGutter/ 目录和 Installed Packages/GitGutter.sublime-package,对以下三处完全不管:
-
Packages/User/GitGutter.sublime-settings:配置残留会让 Sublime 启动时仍尝试加载相关逻辑,命令面板还能搜到git_stage_hunk,点开就报错 -
Cache/下以插件名命名的子文件夹(如pyright、texlab):存语言服务器 socket、编译产物、索引快照,损坏后 CPU 持续 100% -
Local/中的会话状态:比如右键菜单注册项、折叠树快照,删不干净会导致菜单错位、UI 加载失败
必须清空的三个缓存路径,缺一不可
只删 Cache 目录是常见误区。真正拖慢启动、卡死 LSP 的是分散在不同位置的缓存与索引,且部分被后台进程锁死:
- 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
操作前务必先彻底退出 Sublime:Windows 用任务管理器确认所有 sublime_text.exe 消失;macOS 用活动监视器强制退出;Linux 运行 pkill -f "sublime_text"。否则删到一半会被中断,或删完立刻被写回旧缓存。
插件卸载后 CPU 还飙高?重点查 Cache 和 Saved Application State
LSP 类插件(如 pyright、texlab)卸载后最常“阴魂不散”,因为它们的缓存不依赖主插件代码就能被自动拉起:
- Windows:进
%LOCALAPPDATA%\Sublime Text\Cache\,搜索pyright或lsp,删整个匹配文件夹(别只删子文件) - macOS:除了
~/Library/Caches/Sublime Text/,还要进~/Library/Saved Application State/com.sublimetext.4/—— 这个目录会偷偷恢复插件状态,导致“卸了等于没卸” - Linux:
rm -rf ~/.cache/sublime-text/*是安全的,重启后自动重建
删完检查:重启后按 Ctrl+Shift+P 输入 Format with Black,如果还能看到,说明 Packages/User/Black.sublime-settings 或对应缓存没清干净。
重装后插件和设置“复活”的真正原因
不是你删得不够狠,而是忘了登出同步账号。只要执行过 subl --sync-login,哪怕删光 Packages、Cache、Local,首次启动也会从云端拉回插件列表、快捷键绑定甚至 Preferences.sublime-settings:
- Windows:确保
subl在 PATH 中,终端运行subl --sync-logout - macOS/Linux:终端直输
subl --sync-logout - 或通过菜单栏:
Sublime Text → Preferences → Sync Settings → Logout - 不确定是否登录过?查
Packages/User/Package Control.sublime-settings里是否有"sync_login"字段
删完首次启动稍慢是正常的——它在重建基础缓存,但不会再加载旧索引。真正的“自动清理”,是你把这四步变成肌肉记忆:关进程 → 清三处路径 → 扫 Packages/User 配置 → 登出同步。漏掉任何一环,下次卡顿就是它在提醒你。

















