90%的sublime卡顿等问题源于缓存和索引未清理干净;需手动删除cache、index、local三目录,且必须彻底退出进程后操作,避开session/state数据。

Sublime 卡顿、插件失效、右键菜单残留、Goto Definition 失效——90% 是缓存和索引没清干净,不是重装或换硬件能解决的。必须手动删对位置、避开 Session/State 这类会话数据、且每次操作前彻底退出进程。
怎么确认是缓存/索引真问题,不是插件冲突?
别一卡就删文件夹。先验证:关掉 Sublime,按住 Ctrl(Windows/Linux)或 Cmd(macOS)再双击启动。如果这时输入变丝滑,说明是插件或配置加载惹的祸;如果还卡,才是缓存/索引本身出问题。
此时再动手删,方向才对。
必须清的三个核心目录:Cache、Index、Local
只删 Cache 文件夹等于白干——LSP 插件的编译产物、符号数据库、UI 快照都藏在别处。务必关闭所有 sublime_text.exe(Windows)、Sublime Text(macOS)或用 pkill -f "sublime_text"(Linux)后操作:
-
Cache:存插件临时数据(如pyright生成的.pyc),删完重启自动重建 -
Index:存全文搜索和跳转用的底层数据库,体积大、易损坏,直接删整个文件夹(不是子目录) -
Local:存窗口布局、标签页顺序、侧边栏展开状态,碎片化后会导致启动卡顿、菜单错位,可安全删除
对应路径:
Windows:%APPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Cache、%APPDATA%\Sublime Text\Index、%APPDATA%\Sublime Text\Local
macOS:~/Library/Application Support/Sublime Text/Cache、~/Library/Caches/Sublime Text、~/Library/Application Support/Sublime Text/Index、~/Library/Application Support/Sublime Text/Local
Linux:~/.config/sublime-text/Cache、~/.cache/sublime-text、~/.config/sublime-text/Index、~/.config/sublime-text/Local
插件卸载后还“阴魂不散”?重点查这三处残留
Package Control: Remove Package 只删代码,不删配置、不删缓存、不删 UI 状态。比如卸载了 LSP-pyright,CPU 还在狂转,大概率是这些地方没动:
-
Packages/User/下的Pyright.sublime-settings或GitGutter.sublime-commands—— 删掉 -
Cache目录里按插件名搜pyright、texlab、anaconda,整文件夹干掉 -
Local/中某些插件(如SideBarEnhancements)会存持久化折叠状态,删Local最省事
特别注意:LSP 类插件的缓存不清理,下次装同名插件会直接复用旧索引,照样卡。
禁用 index_files 后 Ctrl+P/Ctrl+R 失效,但 folder_exclude_patterns 能救一半
在 Preferences → Settings 用户设置中加 "index_files": false,保存后必须完全退出再重启——只重载设置无效,后台索引线程还在跑。
副作用明确:Ctrl+P 模糊搜索、Ctrl+R 符号跳转基本废掉。如需保留部分能力,配合项目级排除更实际:
"folder_exclude_patterns": ["node_modules", ".git", "__pycache__"]
"file_exclude_patterns": ["*.log", "*.min.js"]
这样既大幅减少索引负担,又不至于让跳转功能完全归零。真正稳定的方案不是全关索引,而是精准排除干扰项。
最常被忽略的是 Local 目录和 Windows 的 %LOCALAPPDATA% 路径——很多人删了 %APPDATA% 就以为完事,结果重装后插件行为依旧诡异,那多半是 Local 里的状态偷偷复活了。











