备份失败主因是未退出Sublime就复制、路径错误或权限异常;必须彻底退出、用Browse Packages确认真实路径、完整备份Packages/User及插件目录,并确保Package Control配置完好。

备份失败不是 Sublime 坏了,而是你正在复制一个被锁住、路径错位或权限异常的目录——90% 的失败发生在没退出编辑器就点“复制”时。
备份前必须彻底退出 Sublime Text
Sublime 在运行时会持续读写 Packages 和 Installed Packages 目录,尤其 .sublime-package 文件在 Windows/macOS 上会被系统锁定。此时强行复制,结果可能是:Packages/GitGutter/ 变成空文件夹、Installed Packages/Package Control.sublime-package 复制出 0 字节文件、或出现 GitGutter~ 这类临时残骸。
实操建议:
- 菜单栏点击 File → Exit(Windows/Linux)或 Sublime Text → Quit Sublime Text(macOS)
- 检查任务管理器(Windows)、活动监视器(macOS)或
ps aux | grep sublime(Linux),确认无subl或sublime_text进程残留 - 右下角托盘图标也要右键退出,别只关窗口
路径抄错了:便携版和常规版绝对不能混
很多人备份失败,是因为在便携版里还去翻 %APPDATA% 或 ~/Library/Application Support,结果把配置覆盖到错误位置。便携版所有数据都在程序同级的 Data 文件夹(注意大小写:大写 D,小写 ata),而常规版才分 Packages 和 Installed Packages 两个独立目录。
最准的路径验证方式:
- 启动 Sublime → Preferences → Browse Packages…,弹出的窗口地址就是你要备份的真实路径
- Windows ST4 用户注意:路径中是
Sublime Text(带空格),不是Sublime Text4 - macOS 终端中路径含空格,必须用反斜杠转义:
~/Library/Application\ Support/Sublime\ Text/Packages
只备份 Packages/User 就迁移?插件根本不会加载
只拷 Packages/User 是最大误区。这个目录里只有你的个性化设置(如 Preferences.sublime-settings、Default (Windows).sublime-keymap),但插件逻辑代码全在 Packages/插件名/ 下(比如 Packages/SideBarEnhancements/)。只备份 User,新机器上菜单空白、快捷键报 command not found,不是配置没生效,是插件压根没装上。
该备份的三类内容:
-
Packages/User整个文件夹(必须) -
Packages/下所有非User的子目录(如EmmyLua、Dracula Color Scheme),跳过名字带~或.tmp的临时文件夹 - 配色方案文件本身(如
Packages/Dracula/Dracula.tmTheme),不是设置里写的路径名;可从状态栏右下角执行UI: Show Scope Name查真实路径
备份后恢复仍失效?检查 ignored_packages 和同步工具干扰
恢复后插件不显示、命令搜不到,先打开控制台(Ctrl + `),输入 sublime.settings().get("ignored_packages")。如果输出里包含你刚恢复的插件名(如 "SideBarEnhancements"),说明 Sublime 自动把它加入了忽略列表——常见于解压路径嵌套、签名异常或 API 版本不匹配。
另一个高频干扰源是云同步工具:
- OneDrive/Dropbox 开启“按需同步”时,
Packages/下文件可能未完全落地,rename 操作被拦截,导致插件加载失败 - 杀毒软件或 Windows Defender 实时保护常锁死
Installed Packages/目录,备份时看似成功,实际文件为空 - 恢复前务必临时关闭这些服务,且确保
Packages/User目录属主是你自己(Linux/macOS 运行sudo chown -R $USER:$(id -gn $USER) ~/.config/sublime-text-4/Packages/User)
真正容易被忽略的是:即使你完整复制了所有目录,只要 Packages/User 里的 Package Control.sublime-settings 缺失或损坏,插件就无法自动重装缓存;而 atomic_save: true 在 OneDrive 或 WSL2 路径下会静默失败,让你误以为“备份成功”,其实新设备上连保存都卡住。


















