备份Sublime Text必须先完全退出程序,再完整备份Packages/User及所有插件子目录(便携版则整份复制Data文件夹),否则易致插件损坏、配置覆盖或残留.tmp/~文件;真实路径须以Preferences→Browse Packages…弹窗为准。

备份前必须确认 Sublime Text 已完全退出
进程未退出时复制 Packages 或 Data 目录,极大概率导致插件目录损坏、配置文件被覆盖或残留 .tmp / ~ 临时文件。Windows 用户需在任务管理器中确认 subl.exe 或 sublime_text.exe 进程已消失;macOS 用户检查活动监视器里是否有 sublime_text;Linux 用户用 ps aux | grep sublime 确认。托盘图标没消失 ≠ 进程已退出,务必手动执行菜单操作:File → Exit(Windows/Linux)或 Sublime Text → Quit Sublime Text(macOS)。
Packages/User 是核心但远远不够
只拷 Packages/User 目录,迁移后会看到:快捷键全失效、右键菜单空白、插件命令报 command not found——这不是设置没加载,是插件压根没存在。因为:
-
Preferences.sublime-settings和Default (Windows).sublime-keymap在User里,但它们只是“开关”和“映射”,不包含功能逻辑 -
Package Control.sublime-settings必须完整保留,否则插件不会自动启用 - SideBarEnhancements、EmmyLua、GitGutter 等插件的全部代码、菜单定义、图标资源,都在各自独立的
Packages/SideBarEnhancements/这类子目录下 - 配色方案如
Dracula.tmTheme也得从对应插件目录里提取,不能只靠设置里写的名称
便携版与常规版的备份路径根本不同
硬记 %APPDATA% 或 ~/Library/Application Support 是最常见翻车点。真实路径永远以 Sublime 内部弹窗为准:
- 启动 Sublime → Preferences → Browse Packages…,弹出窗口的地址就是你要备份的根位置
- 若弹窗指向
Data\Packages,说明你正在用便携版,直接整份备份Data文件夹即可(注意大小写:Data,不是data) - 若弹窗指向系统路径(如
%APPDATA%\Sublime Text\Packages),才是常规版,此时需分别备份:Packages/User+Packages/下所有非User的子目录(跳过~或.tmp开头的) - Linux 用户特别注意:
sublime-text-3和sublime-text-4的配置目录互不兼容,别混用
别碰 Installed Packages 目录
Installed Packages/ 里的 .sublime-package 文件只是缓存,不是源码。备份它反而容易引发冲突:
- Package Control 在启动时会根据
Package Control.sublime-settings自动重装已启用插件,前提是User目录完好 - 如果
Packages/下已有某插件的解压目录(如Packages/EmmyLua/),而Installed Packages/里还留着EmmyLua.sublime-package,优先保留解压版,删掉.sublime-package - 备份时误带入
Installed Packages,恢复后可能触发重复安装、插件初始化失败等静默错误
实际批量备份只需三步:关程序 → 找对路径(用 Browse Packages… 确认)→ 拷 User + 所有插件子目录(便携版就拷整个 Data)。最容易被忽略的是“弹窗路径决定一切”——哪怕你手上有十台机器,每台都该单独点一次 Browse Packages…,而不是凭经验拼路径。











