sublime text卡顿、cpu暴涨、goto definition失效主因是index缓存未清理,必须先彻底退出进程,再同步删除cache、local/index及插件残留配置。

Sublime Text 卡顿、CPU 暴涨、Goto Definition 失效,90% 不是硬件问题,而是缓存和索引没清干净——只删 Cache 目录基本没用,必须同步清理 Index 和插件残留,且必须先彻底退出进程。
为什么删了 Cache 还卡?因为 Index 才是罪魁祸首
Index 文件夹存的是全文搜索、符号跳转(Ctrl+R、Ctrl+P)的底层数据库,损坏或过期后,你会看到“能搜到函数名但点不进去”“项目一打开就 CPU 100%”。它和 Cache 平级,但作用完全不同,不能被忽略。
- Windows 路径:
%APPDATA%\Sublime Text\Local\Index和%LOCALAPPDATA%\Sublime Text\Local\Index(两个都要删) - macOS 路径:
~/Library/Application Support/Sublime Text/Local/Index和~/Library/Caches/Sublime Text/Local/Index - Linux 路径:
~/.config/sublime-text/Local/Index和~/.cache/sublime-text/Local/Index - 别删错成
Index Files或Indexing—— 就找纯叫Index的文件夹,整目录删掉 - 删完首次启动会慢几秒,这是正常重建;若仍卡,说明进程没杀干净或还有 LSP 插件残留
删缓存前不杀进程?文件删不掉还白忙
Sublime Text 4 默认后台常驻,窗口关了 ≠ 进程退出。Windows 下 sublime_text.exe 和 subl.exe 可能同时存在;macOS/Linux 的 LSP 服务线程也锁着缓存文件。不先杀,删一半就中断,或删完立刻被写回旧数据。
- Windows:任务管理器 → 搜索
sublime_text.exe和subl.exe→ 全部“结束任务” - macOS:活动监视器 → 搜索
Sublime Text→ 强制退出所有匹配项 - Linux:终端运行
pkill -f "sublime_text"或pkill -f "subl" - 右下角托盘图标右键选
Exit不够,必须确认进程列表为空
LSP 插件卸载后还在吃 CPU?查这三个残留点
Package Control 的 Remove Package 只删代码,不碰配置、缓存、状态。像 pyright、texlab 这类语言服务器,卸载后仍在后台拉起进程,命令面板还能搜到命令但执行报错。
-
Packages/User/下删配置:如LSP-pyright.sublime-settings、GitGutter.sublime-settings,空文件也要删 -
Cache/中按插件名搜索并整文件夹删除:Windows 在%LOCALAPPDATA%\Sublime Text\Cache\里搜pyright;macOS/Linux 同理在对应Cache路径下操作 -
Local/可直接删:它只存窗口布局、折叠状态、崩溃快照,重启自动生成;长期不清理会导致启动卡顿、主题加载失败 - 检查命令面板是否还有残留命令(如
Format with Black),有就说明某处配置没清干净
别信 Index Rebuild 命令面板选项
Ctrl+Shift+P → Index Rebuild 只重建当前项目索引,对全局损坏的 Index、LSP 编译产物、UI 状态完全无效。它甚至不碰磁盘上的缓存文件,只是刷新内存里那一小块。
- 该命令适合:刚加了几个新文件,想快速让
Ctrl+P搜到它们 - 不适合:卡顿、跳转失效、CPU 飙升等系统性问题
- 真正有效的重建,是删光
Index+Cache+Local后重启,让 Sublime 从零扫描 - 如果项目含
node_modules,删完记得在项目设置里加"folder_exclude_patterns": ["node_modules", ".git"],否则重建又卡死
最易被忽略的点是:Windows 用户常只清 %APPDATA% 下的路径,漏掉 %LOCALAPPDATA%\Sublime Text\Cache 和 Local\Index;macOS 用户容易把 ~/Library/Caches/com.sublimetext.4/ 当成唯一缓存位置,其实 ~/Library/Application Support/Sublime Text/Cache 和 Local/Index 同样关键。删错一个,问题就还在。











