必须彻底退出进程并删除cache、index、local三处路径才能解决sublime卡顿,仅重装无效;windows需结束sublime_text.exe及plugin_host进程,macos用活动监视器强制退出,linux执行pkill -f "sublime_text";删完首次启动稍慢属正常。

重装 Sublime Text 本身不能解决打开慢的问题——90% 的“启动慢”“卡顿”“右键残留”“Goto Definition 失效”,根源是缓存和索引没清干净。直接卸载重装,只要旧缓存还在,一启动就原样复活。
必须先彻底退出进程,否则删了也白删
只关窗口、点叉、甚至用 Cmd+Q / Ctrl+Q 都不行。Sublime 在后台仍驻留进程,锁住 Cache 和 Index 文件。
- Windows:打开任务管理器 → 搜索
sublime_text.exe→ 结束所有相关进程(注意有多个,比如带plugin_host的子进程也要杀) - macOS:活动监视器里搜
Sublime Text,选中全部 → 点击 × 强制退出 - Linux:终端执行
pkill -f "sublime_text",再ps aux | grep sublime确认无残留
删之前务必确认进程已消失,否则部分文件删不掉,或删完重启立刻重建旧缓存。
删哪几个目录?Cache、Index、Local 三处缺一不可
只删 Cache 文件夹等于白干。LSP 插件的符号数据库、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、texlab)会在Cache/下建独立子目录,比如Cache/pyright/,CPU 100% 往往就卡在这儿 - GitGutter、SideBarEnhancements 这类 UI 增强插件,会在
Local/下存图标缓存或状态快照,不删就一直拖慢启动 -
Packages/User/下的配置文件(如Preferences.sublime-settings、Default (Windows).sublime-keymap)若含错误语法或无效引用,也会导致初始化卡住
建议连 Packages/User/ 一起备份后清空,再按需恢复关键配置,比逐个排查更快。
重装后防复发:关 index_files 或精准排除 node_modules
新装完别急着开项目,先改设置防复发。默认 "index_files": true 是性能杀手,尤其遇到 node_modules、.git、dist 这类目录时。
- 最简方案:打开
Preferences → Settings,在右侧用户设置加一行:"index_files": false—— 必须完全退出再重启才生效 - 想保留跳转能力?改用项目级排除:菜单栏
Project → Edit Project,在folders块里加"folder_exclude_patterns": ["node_modules", "__pycache__", ".git", "dist", "build"] - 注意:
folder_exclude_patterns对 LSP 插件也生效,比如pylsp就不会再扫描node_modules里的 Python 文件
真正麻烦的不是重装,而是删漏一个路径、少杀一个进程、或者忘了关 index_files —— 这些细节一错,问题照旧。











