备份后必须校验,否则迁移或恢复大概率静默失效;需先彻底退出Sublime并清空~/.tmp临时文件,再用diff或WinMerge比对Packages/和Installed Packages/目录结构、插件名大小写、核心文件存在性及字节非零,最后通过命令面板、语法检查、右键菜单做功能验证。

Sublime Text 备份后必须校验,否则迁移或恢复大概率失败——因为插件目录被锁、临时文件混入、路径抄错、解压版与 .sublime-package 冲突等问题,不会报错,只会静默失效。
备份前必须退出 Sublime 并清空临时文件
Sublime 运行时会持续写入 Packages 和 Installed Packages 目录,直接复制会导致文件损坏或残留 ~ 和 .tmp 文件。校验第一步不是比对内容,而是确认备份动作本身干净:
- 在任务管理器(Windows)、活动监视器(macOS)或
ps aux | grep sublime(Linux)中确认所有subl或sublime_text进程已退出,包括托盘图标 - 手动点击菜单:File → Exit(Windows/Linux)或 Sublime Text → Quit Sublime Text(macOS),别只关窗口
- 打开
Packages/目录,删掉所有名字带~、.tmp或为空的子目录——这些不是插件,是崩溃残留,不删会影响后续校验
校验核心:比对 Packages 和 Installed Packages 两个目录
只校验 Packages/User/ 是最大误区——它不含任何插件逻辑,只存你的设置和快捷键。真正决定功能是否可用的是整个 Packages/(含 SideBarEnhancements/、EmmyLua/ 等插件目录)和 Installed Packages/(含 SideBarEnhancements.sublime-package 等缓存)。校验方法如下:
- 用
diff -r(macOS/Linux)或 WinMerge(Windows)对比源目录与备份目录的Packages/和Installed Packages/两层结构 - 重点检查:插件名是否完全一致(大小写敏感)、
Packages/PluginName/下是否有plugin.py或main.py、Installed Packages/PluginName.sublime-package是否存在且非零字节 - 若某插件在
Packages/下有解压目录,同时Installed Packages/里还有同名.sublime-package,以解压版为准,删掉后者再校验
便携版和常规版路径不能混,校验前先确认真实位置
很多人校验失败,是因为拿错了基准路径。便携版配置全在程序同级的 Data/(注意 D 大写、ata 小写),而常规版是分离的 Packages/ 和 Installed Packages/。最准的验证方式不是查文档,而是让 Sublime 自己说:
- 启动 Sublime → Preferences → Browse Packages…,弹出的窗口地址就是你该校验的真实
Packages/路径 - 便携版用户:确保备份的是
sublime_text/Data/整个目录,不是sublime_text/Packages/(那只是空壳) - 常规版 Windows 用户:路径是
%APPDATA%\Sublime Text\Packages,不是安装目录下的Packages;macOS 用户注意空格转义:~/Library/Application\ Support/Sublime\ Text/Packages
校验后别急着用,先快速功能验证
目录结构一致不等于功能正常。有些插件依赖运行时生成的缓存或配置文件,校验完需做最小化功能测试:
- 启动 Sublime,打开命令面板(Ctrl+Shift+P),输入插件名(如
SideBarEnhancements),看是否有对应命令出现 - 新建一个文件,设语法为 JSON → 输入
{}→ Ctrl+S,观察右下角是否显示JSON: 0 errors(说明SublimeLinter-jsonlint类插件已加载) - 右键侧边栏,检查是否有新增菜单项(如 “Open in Terminal”、“Copy Path”),缺失即表示插件未生效
最容易被忽略的是插件间的覆盖关系:比如 Packages/EmmyLua/ 和 Installed Packages/EmmyLua.sublime-package 同时存在时,Sublime 会优先加载前者,但若备份时只拷了后者,新机器上就彻底没 Lua 支持——校验必须落到具体文件是否存在、是否可读、是否被识别这三个层面。


















