插件运行缓慢八成是缓存堆积或损坏所致,清空Cache、Index和Package Control三个目录最有效;需完全退出Sublime Text后操作,避免误删会话文件。

插件运行缓慢,八成是缓存堆积或损坏导致的——直接清空 Cache 和 Index 目录最立竿见影,比重装插件、重启编辑器都管用。
为什么插件变慢?不是代码问题,是索引和临时文件拖了后腿
Sublime 的插件(尤其是 LSP、GitGutter、BracketHighlighter 这类实时分析型插件)会在后台生成大量临时索引和编译产物。这些文件不随插件卸载自动清理,长期积累会导致:
• Goto Definition 卡顿甚至失败
• 右键菜单响应延迟或报错(如 KeyError: 'git_gutter')
• CPU 占用持续 30%+,风扇狂转
• 某些插件命令面板里能搜到,但一按就无响应
根本原因不是插件本身写得差,而是 Index 文件夹里的符号索引损坏,或 Cache 里残留了旧版插件的二进制缓存(比如 pyright 编译的 .pyc 或 texlab 的语言服务器快照)。
必须清的三个缓存位置:Cache、Index、Package Control
务必先完全退出 Sublime Text(包括右下角托盘进程),否则删不动或删完立刻重建旧缓存。
-
Cache目录:存插件运行时临时数据,体积小但最常出问题。删它安全,重启后自动重建。
• Windows:%APPDATA%\Sublime Text\Cache和%LOCALAPPDATA%\Sublime Text\Cache
• macOS:~/Library/Application Support/Sublime Text/Cache和~/Library/Caches/com.sublimetext/Cache
• Linux:~/.config/sublime-text/Cache和~/.cache/sublime-text/Cache -
Index目录:这才是大头。它存全文搜索和跳转用的符号索引,尤其打开含node_modules或vendor的项目后极易膨胀、卡死。
• 路径与Cache同级,例如 Windows 是%APPDATA%\Sublime Text\Packages\Cache\Index
• 不要删里面某个子文件,直接删整个Index文件夹;删完首次打开项目会稍慢,但之后就顺了 -
Package Control 缓存:插件安装包、元数据、下载记录全堆在这,影响插件列表加载速度。
• Windows:%APPDATA%\Sublime Text\Cache\Package Control
• macOS/Linux:对应路径下同名目录
• 顺手进Packages/User/Package Control/cached_packages/,删掉所有.sublime-package文件(重装时会重新下载)
插件残留缓存怎么精准定位?别一股脑全删
如果你只怀疑某个插件(比如 LSP-pyright 或 LaTeXTools)拖慢了性能,可以针对性清理,避免误伤其他插件缓存:
- 进系统缓存路径(上面列出的
Cache或Caches目录),用文件名搜索插件关键字,例如pyright、texlab、sublimelinter,删掉对应文件夹 - 某些插件还会在
Packages下建独立子目录(如LSP-pyright、SideBarEnhancements),它们可能自带cache/或data/子文件夹,一并删掉 - Linux/macOS 用户可用终端快速查找:
find ~/.cache/sublime-text -name "*pyright*" -type d -delete
清完重启还卡?检查是否动错了地方
最容易被忽略的坑:
• 删了 Session.sublime_session 或 Local/State —— 它们不是缓存,是会话状态,误删会导致未保存标签页丢失、侧边栏折叠状态重置;仅当菜单错位、主题失效等 UI 异常时才考虑重命名 State 文件夹为 State.bak
• 忘记删 Installed Packages 里的 .sublime-package 压缩包,它可能在下次启动时自动解压出旧版插件
• 没关干净进程:Windows 任务管理器里确认没有残留的 sublime_text.exe,macOS 活动监视器里找 Sublime Text 进程
清理后首次启动稍慢是正常的——它在安静重建索引。如果 2 分钟后仍卡在“Scanning folders for symbols…”或 CPU 不降,说明有插件正在后台疯狂重建缓存,这时就得单个排查插件了。










