Sublime启动变慢需手动清理Cache、Index、Local三个核心目录,因Index Rebuild仅重建项目符号索引,无法修复全局缓存、插件编译产物及UI状态文件问题。

Sublime 启动变慢,八成是缓存和索引文件堆积或损坏导致的——不是“稍慢”,而是首次启动卡死、插件命令不响应、LSP 直接挂起。必须手动清,不能只点 Index Rebuild。
为什么 Index Rebuild 按了没用
执行 Index Rebuild 只重建当前项目的符号索引,对全局缓存、插件编译产物(如 pyright 生成的 .pyc)、UI 状态文件(Local/ 里的窗口布局)完全无效。这些残留一旦出错,会直接传导为启动卡顿、菜单错位、主题加载失败。
- 它不碰
Cache目录里已损坏的插件临时数据 - 它跳过
Index目录中膨胀的全文搜索数据库(尤其含node_modules的项目) - 它对
Local/中碎片化的会话快照、折叠状态毫无影响
必须清的三个核心目录位置
务必先彻底退出 Sublime Text(Windows 查任务管理器中的 sublime_text.exe,macOS 查活动监视器里的 Sublime Text,Linux 执行 pkill -f "sublime_text"),再操作以下路径:
-
Cache:存插件运行时临时数据,体积小但最常出问题。删完重启自动重建 -
Index:存全文搜索和Goto Definition的底层数据库。删整个文件夹,别只删子目录;删后首次打开项目稍慢属正常 -
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 卸载插件,只删代码不删状态。比如卸载了 LSP-pyright,它的 Python 类型缓存可能还躺在 %LOCALAPPDATA%\Sublime Text\Cache\pyright 里;右键菜单残留的 “Format with Black” 很可能是 Packages/User/Black.sublime-settings 没清干净。
- 检查
Packages/User/下是否有同名的PluginName.sublime-settings或PluginName.sublime-commands - 大型插件(如
LSP、GitGutter)的缓存常藏在Cache/子目录中,直接删整个插件名对应的子文件夹 - 若插件写入过本地状态(如
SideBarEnhancements在Local/存折叠项),可临时重命名Local文件夹强制重置
清理后仍卡?关掉 index_files + 排除高危目录
即使清完缓存,只要项目里有 node_modules、dist 这类目录,Sublime 默认还是会尝试索引它们,内存持续飙升。这时要改设置:
- 在用户设置中添加
"index_files": false,并**完全退出 Sublime 再重启**(仅重载设置无效) - 在
Project → Edit Project中配置folder_exclude_patterns,例如:["node_modules", "__pycache__", ".git", "dist"] - 排除后这些目录不会出现在侧边栏,也彻底隔离插件扫描和
Find in Files拖累
真正顽固的卡顿,往往不是缓存没删干净,而是 index_files 还开着 + folder_exclude_patterns 没配全——这两项不落实,清十次缓存也没用。

















