sublime text 缓存必须手动清理cache和index目录,关闭进程后删除对应系统路径下的缓存文件夹,并清理插件残留配置与local/state状态数据,否则会导致插件失效、lsp卡死或启动崩溃。

Sublime 的缓存不清理,不是“慢一点”,而是会直接导致插件失效、LSP 卡死、甚至启动就崩溃。 它不像浏览器缓存那样被动堆积,而是主动参与索引构建、语法分析和 UI 状态维护——一旦出错或过期,问题会层层传导。真正有效的“清理”,从来不是点个按钮,而是按需删对位置、避开陷阱、留好退路。
Cache 和 Index 目录必须手动清,命令面板的 Index Rebuild 不够用
很多人以为按 Ctrl+Shift+P → 输入 Index Rebuild 就万事大吉,其实它只重建当前项目的符号索引,对损坏的全局缓存、插件编译产物、UI 状态文件完全无效。
- 关闭 Sublime Text(务必确认进程已退出,Windows 任务管理器查
sublime_text.exe,macOS 活动监视器查Sublime Text) - 进对应路径删空整个文件夹:
Windows:%APPDATA%\Sublime Text\Cache和%LOCALAPPDATA%\Sublime Text\Cache
macOS:~/Library/Application Support/Sublime Text/Cache和~/Library/Caches/Sublime Text
Linux:~/.config/sublime-text/Cache和~/.cache/sublime-text - 同级目录下还有
Index文件夹,也一并清空——它存的是全文搜索和 Goto Definition 的底层数据库,损坏后补全延迟、跳转失败都源于此
插件卸载 ≠ 缓存清除,Package Control: Remove Package 只删代码不删状态
你用 Package Control: Remove Package 卸载了 LSP-pyright,但它的 Python 类型缓存可能还躺在 %LOCALAPPDATA%\Sublime Text\Cache\pyright 里;右键菜单里残留的 “Format with Black” 选项,大概率是 Packages/User/Black.sublime-settings 或 Local/ 下的持久化配置没清干净。
- 删完插件后,去
Cache目录用文件名搜索插件关键字(如pyright、texlab、anaconda),删掉整个匹配文件夹 - 检查
Packages/User/下是否有同名的PluginName.sublime-settings或PluginName.sublime-commands,这些配置不会被自动删除 - 若插件曾写入本地状态(比如
SideBarEnhancements会在Local/存折叠状态),可临时重命名Local文件夹来强制重置
别碰 Packages 和 Installed Packages 以外的目录?错,Local 和 State 才是卡顿元凶
很多人只敢动 Cache,却放任 Local 和 State 膨胀——前者存未保存的会话、崩溃恢复数据、窗口布局;后者存 UI 状态(侧边栏展开项、标签页顺序、折叠区域)。长期运行后它们会碎片化,造成启动卡顿、菜单错位、主题加载失败。
-
Local可安全删除:它只是运行时快照,重启后自动生成新文件 -
State(部分版本叫Local/State或独立文件夹)建议重命名为State.bak而非直接删,万一界面异常可快速回滚 - 切记保留
Packages(插件源码)、Installed Packages(.sublime-package 包)、Packages/User/(你的自定义设置)——这三处删了,等于重装插件和重配编辑器
最常被忽略的其实是同步功能:subl --sync-logout 不执行,删光本地所有目录后,重启 Sublime 还是会把云端的 Preferences.sublime-settings 和插件列表拉回来。缓存位置因系统而异,但清理逻辑一致:关进程 → 删 Cache + Index + Local → 搜关键词清插件残留 → 登出同步再启动。











