务必先彻底关闭sublime text再备份,否则热重载和临时写入会导致配置丢失、文件残留;真实路径应通过“browse packages…”获取;完整备份需包含packages/user、其他插件子目录及installed packages;便携版只需迁移data文件夹。

关掉 Sublime Text 再动手,否则备份白做
Sublime Text 运行时会锁住 Packages 和 Installed Packages 目录,同时热重载插件、写入临时配置。你一边复制,它一边覆盖,结果常是:Preferences.sublime-settings 被重置、插件目录里多出 ~ 或 .tmp 文件、Package Control.sublime-settings 丢失启用状态。
务必确认进程已彻底退出:
- Windows:任务管理器里查
subl.exe或sublime_text.exe - macOS:活动监视器中找 Sublime Text,或终端执行
ps aux | grep sublime - Linux:运行
pgrep -f sublime,确保无残留
别只关窗口——托盘图标还在就说明进程没死。
认准真实路径,别硬记 %APPDATA% 或 ~/Library
硬记路径容易错,尤其 macOS 路径含空格、Linux 区分 sublime-text-3 和 sublime-text-4。最准方法永远是:
启动 Sublime Text → Preferences → Browse Packages…,弹出的窗口地址就是你要操作的真实路径。
常见路径对照:
- 常规版 Windows:
%APPDATA%\Sublime Text\Packages - 常规版 macOS:
~/Library/Application Support/Sublime Text/Packages - 常规版 Linux:
~/.config/sublime-text/Packages - 便携版(所有系统):
Data\Packages(注意大小写:大写D,小写ata)
如果弹窗指向 Data\Packages,你就在用便携版——别去翻 %APPDATA%,那是常规版的地盘。
只拷 Packages/User 是最大误区
Packages/User 里只有你的配置文件:Preferences.sublime-settings、Default (Windows).sublime-keymap、Package Control.sublime-settings、自定义 .sublime-build 等。但它不含任何插件代码。
比如你装了 SideBarEnhancements,它的右键菜单、删除逻辑、图标资源全在 Packages/SideBarEnhancements/ 目录里。只拷 User,新环境里按快捷键会报 command not found,右键菜单空白。
真正要备份的是:
-
Packages/User整个文件夹(必选) -
Packages/下所有非User的子目录(如GitGutter/、EmmyLua/、Dracula Color Scheme/) -
Installed Packages/目录(含.sublime-package缓存,不是必须但建议保留)
配色方案不能只靠 "color_scheme" 设置项——它只是路径,真正起作用的是 .tmTheme 或 .sublime-color-scheme 文件,得一并拷走。
便携版迁移只需搬走 Data 文件夹
便携版所有配置全在程序同级的 Data 文件夹里(注意大小写:必须是大写 D 小写 ata),里面已经包含了 Packages、Installed Packages、Settings、Cache 全套。
实操建议:
- 关闭程序后,直接复制整个
Data文件夹 - 迁移到新电脑时,把整个便携版文件夹(含
sublime_text.exe+Data)一起拷过去就行 - 升级便携版?先备份
Data,再用新版sublime_text.exe替换旧版同名文件,Data保持原位不动
验证是否成功:启动后按 Ctrl+Shift+P → 输入 Package Control: List Packages,看看插件是否全在;再点 Preferences → Browse Packages…,路径应指向你当前目录下的 Data\Packages。
最容易被忽略的是:配色文件和快捷键绑定依赖具体插件目录结构,而不是单个 JSON 配置。哪怕 Preferences.sublime-settings 没问题,Packages/Dracula/Dracula.tmTheme 缺失,主题照样回退到默认;SideBarEnhancements.sublime-keymap 没跟着拷过去,右键菜单就空着。











