sublime卡顿等问题90%源于缓存和索引未彻底清理,须按顺序关闭进程、删除cache、index、local三处路径及插件残留配置,否则重启无效。

Sublime 卡顿、启动慢、右键菜单残留、Goto Definition 失效,90% 不是硬件问题,也不是插件本身有 bug,而是缓存和索引没清干净——删错位置、删不全、进程没退干净,重启等于白干。
为什么删了 Cache 还卡?必须连 Index 和 Local 一起动
只删 Cache 文件夹,基本解决不了 Goto Definition 失效或 CPU 持续 100%。因为:
-
Index目录(和Cache同级)存的是全文搜索和符号跳转的底层数据库,损坏后Ctrl+R、Ctrl+P就变“假响应” -
Local目录(如%APPDATA%\Sublime Text\Local)存窗口折叠状态、崩溃恢复快照、UI 布局,长期不清理会导致启动卡顿、菜单错位、主题加载失败 - Windows 用户常漏掉
%LOCALAPPDATA%\Sublime Text\Cache,这里藏了 LSP 插件最顽固的编译缓存
删之前必须彻底退出进程,否则文件被锁住
只关窗口不行,托盘图标还在运行,Cache 和 Index 下的文件会被锁住,删了也立刻重建旧缓存。确认进程已消失再动手:
- Windows:任务管理器里搜
sublime_text.exe,全部结束 - macOS:活动监视器查
Sublime Text和plugin_host,强制退出 - Linux:
pkill -f "sublime_text",再ps aux | grep sublime确认无残留
删完首次启动稍慢是正常的——它在重建基础缓存,但不会再加载旧索引。
插件卸载后还卡?重点清 Packages/User 和 Cache 下的同名残留
Package Control: Remove Package 只删主代码和 .sublime-package,对插件实际运行产生的缓存、配置、状态文件完全不管。常见表现:
- 右键菜单里还有 “Format with Black”,但点开报错 —— 说明
Packages/User/Black.sublime-settings或Cache/black/没清 - CPU 狂飙,任务管理器看到
pyright进程仍在跑 ——Cache/pyright/整个文件夹还躺在%LOCALAPPDATA%\Sublime Text\Cache\里 - 命令面板能搜到
LSP: Restart Server,但执行失败 ——Packages/User/LSP-pyright.sublime-settings还在,且指向已不存在的二进制路径
实操建议:关掉 Sublime 后,进 Packages/User/ 搜插件名,删掉所有 *.sublime-settings 和 *.sublime-commands;再进各 Cache 路径,用文件名搜索(如 pyright),整文件夹干掉。
禁用 index_files 能立刻止痛,但得接受 Ctrl+P/R 失效
如果你常开含 node_modules 的前端项目,index_files 是卡顿主因。关它比删缓存还快:
- 打开
Preferences → Settings,在右侧用户设置中加一行:"index_files": false - 必须完全退出 Sublime(不是重载设置),再重启才生效
- 副作用明确:
Ctrl+P模糊搜索、Ctrl+R符号跳转基本不可用;若需保留部分能力,可配合"folder_exclude_patterns": ["node_modules", ".git"] - 别开
re_index_on_load,它只对单文件有效,开错反而每次开脚本都卡住
真正麻烦的不是删哪几个文件夹,而是删完之后,你忘了检查 plugin_host 进程是否还在吃内存,或者没注意到 Local/State 里堆积了三年前的崩溃恢复快照——这些细节不处理,卡顿会原样回来。











