必须先彻底退出Sublime Text进程,否则删不动也白删;需结束sublime_text.exe/subl等全部后台进程,再删除Cache、Index、Local三处目录及Packages/User配置和Cache中插件残留文件夹,并执行subl --sync-logout防止云端同步复活。

必须先彻底退出 Sublime Text 进程,否则删不动也白删
窗口关了不等于进程退出——托盘图标、后台 LSP 服务、同步监听都在持续运行,会锁住 Cache、Index 下的文件。删之前务必确认进程已消失:
- Windows:打开任务管理器 → 搜索
sublime_text.exe和subl.exe→ 全部结束任务 - macOS:活动监视器 → 搜索
Sublime Text和plugin_host→ 强制退出所有匹配项 - Linux:终端执行
pkill -f "sublime_text",再用ps aux | grep sublime确认无残留
没杀干净就删,部分文件删不掉,或一启动立刻重建旧缓存。
删哪几个目录?Cache、Index、Local 三处缺一不可
Cache 存临时编译产物和插件运行时数据;Index 是全文搜索和 Goto Definition 的底层数据库;Local 记录窗口折叠、崩溃恢复、UI 布局——只清 Cache 解决不了跳转失效或启动卡顿。
- Windows:
%APPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Local\Index、%APPDATA%\Sublime Text\Local - macOS:
~/Library/Application Support/Sublime Text/Cache、~/Library/Caches/Sublime Text、~/Library/Application Support/Sublime Text/Local/Index、~/Library/Application Support/Sublime Text/Local - Linux:
~/.config/sublime-text/Cache、~/.cache/sublime-text、~/.config/sublime-text/Local/Index、~/.config/sublime-text/Local
注意:Index 就是纯叫 Index 的文件夹,不是 “Index Files” 或项目级索引;Local 下的 Session.sublime_session 文件控制“最近打开的文件”,删它才真正清历史。
插件卸载后还卡?重点扫 Packages/User 和 Cache 下的同名残留
Package Control: Remove Package 只删插件代码和 .sublime-package,完全不管配置、状态、缓存。常见症状:
- CPU 持续 100%,
pyright进程还在跑 → 去%LOCALAPPDATA%\Sublime Text\Cache\pyright整夹删除 - 命令面板能搜到
LSP: Restart Server但点开报错 → 检查Packages/User/LSP-pyright.sublime-settings是否还在 - 右键菜单残留 “Format with Black” → 删除
Packages/User/Black.sublime-settings和Black.sublime-commands
实操建议:关掉 Sublime 后,进 Packages/User/ 搜插件名,删所有 *.sublime-settings 和 *.sublime-commands;再进各 Cache 路径,用文件名搜索(如 pyright),整文件夹干掉。
首次启动稍慢是正常的,但别让它自动拉回旧配置
删完重启,Sublime 会重建基础缓存,所以前几秒响应略慢——这是健康信号。但如果发现插件、设置、甚至 License 又“复活”,大概率是没执行 subl --sync-logout。
只要登过账号,首次启动就会从云端同步 Preferences.sublime-settings、快捷键、插件列表。Windows 用户需确保 subl 在 PATH 中;macOS/Linux 直接终端执行即可。不确定是否登过?查 Packages/User/Package Control.sublime-settings 里有没有 "sync_login" 字段。


















