Sublime Text 备份必须关闭程序后复制真实 Packages/User 及所有插件目录(如 SideBarEnhancements),路径需通过 Preferences → Browse Packages… 获取,便携版则复制同级 Data 文件夹。

Sublime Text 本地数据不能靠“导出按钮”备份,所有配置、插件、快捷键、主题都以明文文件形式散落在磁盘上,关掉编辑器后直接复制对应目录才是唯一可靠方式。
怎么找到你的真实 Packages/User 路径?
别硬记 %APPDATA% 或 ~/Library/Application Support —— 不同系统、ST 版本(3/4)、便携版/常规版,路径全不同。最准的方法永远是:
启动 Sublime Text → Preferences → Browse Packages…,弹出的窗口地址就是你要操作的真实位置。
常见误区:
- macOS 终端里路径含空格,必须写成
~/Library/Application\ Support/Sublime\ Text/Packages/User,少一个反斜杠就进错目录 - Linux 用户注意:ST4 是
~/.config/sublime-text-4/Packages/User,不是sublime-text - 便携版弹窗显示的是
Data\Packages,说明你该去程序同级的Data文件夹里找,而不是翻 %APPDATA%
只复制 User 文件夹为什么不行?
因为 Packages/User 只存你的配置文件(Preferences.sublime-settings、Preferences.sublime-keymap、Package Control.sublime-settings),但插件本身不在里面。
比如你用了 SideBarEnhancements,它的右键菜单、删除命令、图标资源全在 Packages/SideBarEnhancements/ 目录里。只拷 User,新机器上按 ctrl+shift+k 会报 command not found。
必须一并复制:
-
Packages/User整个文件夹(必选) -
Packages/下所有非User的子目录(如EmmyLua、Dracula Color Scheme),跳过名字带~或.tmp的临时文件夹 - 配色方案文件本身(如
Packages/Dracula/Dracula.tmTheme),不能只靠color_scheme设置项里的路径去猜
便携版用户怎么备份?
便携版所有配置全塞在程序同级的 Data 文件夹里(注意大小写:大写 D,小写 ata),和 sublime_text.exe(Windows)或 sublime_text(macOS/Linux)在同一级目录。
操作极简单:
- 关掉 Sublime Text(确认进程已退出,包括托盘图标)
- 复制整个
Data文件夹到 U 盘或云盘 - 迁移时,把整个便携版文件夹(含
sublime_text.exe和Data)一起拷过去,双击就能用
不用管 Packages 或 Installed Packages——它们都在 Data 里面,Data\Packages 就是常规版的 Packages,Data\Installed Packages 就是常规版的 Installed Packages。
备份前必须关掉 Sublime,否则会丢数据
Sublime 在运行时持续读写 Packages 和 Installed Packages 目录,尤其 .sublime-package 文件会被系统锁定;同时它还会热重载插件目录,你一边复制一边它一边写,极易导致:
- 插件目录损坏(出现空文件夹或
.tmp后缀残留) - 配置被覆盖(比如刚改完
Preferences.sublime-settings,备份时却拷了旧版) - 新环境里插件不加载、主题不生效、快捷键绑定失败
验证是否彻底退出:
- Windows:任务管理器中确认没有
sublime_text.exe进程 - macOS:活动监视器中搜索
subl或sublime - Linux:终端执行
ps aux | grep sublime,无输出才算干净
真正麻烦的从来不是“怎么备份”,而是备份时没关程序、路径抄错、漏掉插件目录——这三件事一碰,恢复后打开就是个裸编辑器,连括号高亮都可能没了。











