必须先完全退出 Sublime Text 进程,否则缓存文件被锁住导致删除失败或静默跳过;Windows 提示“文件正在使用”,macOS/Linux 则跳过;Sublime Text 3 和 4 数据目录不共用,路径不同,便携版数据在程序同级 Data 文件夹;备份只需 Packages/User 和非 User 插件子目录,勿备份 Cache、Index 等运行时目录。

必须先完全退出 Sublime Text 进程
缓存文件被锁住时,删一半会失败或跳过——Windows 提示“文件正在使用”,macOS/Linux 则静默跳过。窗口关了 ≠ 进程退出,Sublime Text 4/3 默认常驻后台监听剪贴板、LSP、同步状态。
实操建议:
- Windows:Ctrl+Shift+Esc 打开任务管理器 → 搜索
sublime_text.exe和subl.exe→ 全部右键“结束任务” - macOS:活动监视器 → 搜索
Sublime Text→ 选中所有匹配项 → 点击 ✕ 强制退出 - Linux:终端执行
pkill -f "sublime_text"或pkill -f "subl"
确认你要清理的是哪个版本的数据目录
Sublime Text 3 和 4 的用户数据**不共用路径**,删错目录等于白干。v3 数据在带数字的路径里(如 %APPDATA%\Sublime Text 3),v4 是统一的 Sublime Text(不含数字)。便携版更特殊,所有数据都在程序同级的 Data 文件夹里。
别靠记忆拼路径,最准的方法是:
- 启动 Sublime Text → Preferences → Browse Packages… → 弹出窗口地址就是你该操作的真实位置
- 如果弹窗指向
Data\Packages,说明你在用便携版,别去翻%APPDATA% - Windows ST4 用户注意:
Sublime Text中有空格,不是Sublime Text4
备份前快速检查 Packages 目录有没有损坏痕迹
运行中复制或异常退出容易留下临时文件,这些不能备份,否则迁移后可能引发插件加载失败或命令报错。
检查要点:
- 进入
Packages目录,删掉所有名字带~或.tmp的文件夹/文件 - 确认
Installed Packages下没有重复的PluginName.sublime-package和同名解压目录(如既有EmmyLua.sublime-package,又有Packages/EmmyLua/)→ 优先保留解压版,删掉 .sublime-package - 别备份整个
Packages目录——里面混着Package Storage、Cache、Session等运行时生成内容,只备份Packages/User+ 所有非User的插件子目录(如GitGutter、Dracula Color Scheme)
要不要备份 Cache 目录本身?
不用。Cache 是纯运行时产物,重建即可。首次启动稍慢是正常的,但不会再加载旧的损坏索引。真正需要关注的是 Cache 里是否藏有 LSP 插件(如 pyright、texlab)的 socket 文件或编译缓存——这些不清,重启后 CPU 仍可能飙高。
所以清理策略是:
- 删 Cache 目录本身(
%LOCALAPPDATA%\Sublime Text\Cache等) - 额外检查
Local\Index和Cache下是否有插件名关键词(如搜pyright),整文件夹一并删掉 - 别只删
Cache——Sublime 的缓存分散在三处:Cache、Local\Index、Local下的 socket 或状态文件


















