备份 sublime text 必须先彻底退出程序并确认进程消失,仅备份 user/ 目录、插件源码子目录(如 gitgutter/)和 .tmtheme 配色文件,路径需按便携版(data/packages)或常规版(%appdata%\sublime text\packages 等)区分,迁移后须验证 package control、配色生效及路径兼容性。

备份前必须完全退出 Sublime Text
Sublime 在运行时会锁住 Packages 和 Installed Packages 目录,边复制边写入极易产生损坏或残留的 .tmp、~ 文件。哪怕托盘图标还在,也得进任务管理器确认 subl 或 sublime_text 进程已彻底消失。macOS 用户尤其注意:菜单栏里点 Sublime Text → Quit Sublime Text,不能只关窗口。
只拷这三类东西,别全选整个 Packages 文件夹
很多人以为“备份 User 文件夹就够了”,结果迁移后插件全失效、快捷键不响应——因为插件逻辑不在 User/ 里,而在各自独立的子目录中。
-
User/目录:必须整份拷,含Preferences.sublime-settings、Default (Windows).sublime-keymap、各插件的*.sublime-settings - 插件源码目录:如
GitGutter/、SideBarEnhancements/等非User的子目录,它们是解压后的实际代码,直接加载 - .tmTheme 配色文件:不是 JSON 设置,而是 XML 文件,例如
Packages/Dracula/Dracula.tmTheme,从状态栏右下角执行UI: Show Scope Name可查真实路径
不用管 Installed Packages/ 下的 .sublime-package 文件——那是 Package Control 缓存,删了重启会重装;但它的存在 ≠ 插件当前启用,不能作为备份依据。
便携版和常规版路径完全不同,别抄错
便携版所有配置都在程序同级的 Data/Packages(注意大小写:D 大写,ata 小写),而常规版分两个独立目录:Packages 和 Installed Packages。Windows 路径是 %APPDATA%\Sublime Text\Packages,macOS 是 ~/Library/Application Support/Sublime Text/Packages(命令行需转义空格),Linux 则因版本不同可能是 sublime-text-3 或 sublime-text-4 ——混用会导致配置不生效。
最准验证方式:启动 Sublime → Preferences → Browse Packages…,弹出窗口的路径就是你该备份的真实位置。
备份后别急着恢复,先检查三件事
迁移或重装后,光把文件丢进去不等于万事大吉。容易被忽略的其实是环境一致性:
- 确认
Package Control已重装且列表完整:菜单Preferences → Package Settings → Package Control → Settings – User里应有有效配置 - 配色是否真生效:状态栏右下角点开主题名,看是否显示你备份的那个
.tmTheme文件路径 - 路径含中文或空格的插件(如某些自定义 build 系统)可能在新环境中加载失败,建议先用纯英文路径验证基础功能
真正防手残的不是备份动作本身,而是每次修改关键设置(比如改了 save_on_focus_lost 或加了 auto_save_hook)前,顺手压缩一份当前 User/ + 插件目录——比事后翻 Git 历史快得多。











