Sublime卡顿、启动慢、右键残留、Goto Definition失效,90%因缓存与索引未清干净:必须彻底退出进程(任务管理器/活动监视器/pkill),再手动删除Cache、Index、Local三处全部路径(含Windows %LOCALAPPDATA%、macOS ~/Library/Caches、Linux ~/.cache等),并清除Packages/User配置及插件名对应缓存文件夹,最后关闭"index_files": false防复发。

Sublime 启动慢、卡顿、右键菜单残留、Goto Definition 失效,90% 是缓存和索引没清干净——不是重装或换配置能解决的,必须手动删对位置、删全路径、且进程得彻底退出。
必须先完全退出 Sublime,否则删不动也白删
Windows 任务管理器里搜 sublime_text.exe,macOS 活动监视器查 Sublime Text,Linux 执行 pkill -f "sublime_text"。只关窗口不行,托盘图标还在运行,Cache 和 Index 下的文件会被锁住,删了也立刻重建旧缓存。
- 删之前确认进程已消失,否则部分文件删不掉,或者删完一启动就恢复
- 安全模式(按住 Ctrl/Cmd 启动)不能替代退出操作,它只是跳过插件加载,但后台索引线程仍在读写缓存
- 尤其 Windows 用户常漏掉
%LOCALAPPDATA%\Sublime Text\Cache,只清了%APPDATA%路径,结果插件照样卡
删哪几个目录?Cache、Index、Local/State 三处缺一不可
Sublime 的缓存分散在多个系统级路径,只删 Cache 文件夹等于白干。LSP 插件(如 pyright、texlab)的符号数据库、UI 状态、崩溃恢复数据都藏在别处。
- Windows:
%APPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\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 -
Index不是Index Files,就是纯叫Index的文件夹;删它才能修复Goto Definition失效、全文搜索变慢 -
Local目录存的是会话快照(窗口布局、折叠状态、未保存恢复点),长期不清理会导致启动卡顿、菜单错位
插件卸载后还卡?重点清这三类残留
Package Control 的 Remove Package 只删主代码和 .sublime-package,对插件实际运行产生的缓存、配置、状态文件完全不管。比如卸载了 LSP-pyright,它的 Python 类型缓存可能还躺在 Cache/pyright/ 里,CPU 照样 100%。
- 进
Packages/User/删除同名配置:LSP-pyright.sublime-settings、GitGutter.sublime-settings等 - 在所有缓存路径(尤其是
Cache和Caches)中用插件名搜索,如pyright、texlab、anaconda,整文件夹删掉 -
Local/下某些插件(如SideBarEnhancements)会持久化侧边栏状态,直接删Local或临时重命名它来强制重置 - 别信“重启生效”,删完必须冷启动——双击图标打开,别用“Open Recent”或命令行带参数启动
光删不够,还得关掉 index_files 防复发
删完缓存后如果没关 index_files,第一次打开项目时它又会扫整个目录重建索引,遇到 node_modules 或 dist 就卡死。这不是要不要索引的问题,而是默认行为太激进。
- 进
Preferences → Settings,右侧用户设置加这一行:"index_files": false - 副作用明确:
Ctrl+R、Ctrl+Click跳转失效,但Ctrl+P(按文件名)、Ctrl+Shift+F(文本搜索)仍可用 - 若需保留部分能力,不要全局关,改用项目级排除:
"folder_exclude_patterns": ["node_modules", ".git", "__pycache__"],且该配置必须写在Project → Edit Project里才生效 - 顺手关掉自动恢复:
"remember_open_files": false和"hot_exit": false,否则上次打开的十几个大项目会变成启动包袱
最常被忽略的是 Local 目录和系统级 Caches 路径(特别是 Windows 的 %LOCALAPPDATA%),很多人删完 %APPDATA% 就以为完事,结果重装后插件行为依旧诡异——那多半是 Local 里的状态偷偷复活了。
















