必须关闭Sublime Text进程再备份,否则热重载和文件锁会导致插件失效、配置丢失;通过Preferences→Browse Packages…确认真实路径,完整复制Packages/User、所有非User插件子目录及.tmTheme配色文件。

备份前必须关掉 Sublime Text 进程
不关进程直接复制,90% 的备份会失效。Sublime 在运行时持续热重载 Packages/ 目录、锁住 Installed Packages/ 中的 .sublime-package 文件,并可能在你复制途中写入临时文件(如 GitGutter~ 或 SideBarEnhancements.tmp)。结果就是:插件目录缺文件、快捷键报 command not found、右键菜单空白。
确认已彻底退出的方法:
- Windows:任务管理器 → 详细信息页 → 搜索
sublime_text.exe或subl.exe→ 全部结束 - macOS:活动监视器中找
Sublime Text,或终端执行ps aux | grep sublime→ 若有输出,用kill -9 [PID]杀掉;务必点菜单栏Sublime Text → Quit Sublime Text,仅关窗口无效 - Linux:运行
pgrep -f sublime或pkill -f "sublime_text",确保无残留进程
怎么找对 Packages 目录的真实路径
硬记 %APPDATA%、~/Library/Application Support 或 ~/.config/sublime-text-4 极易出错——空格没转义、版本号写错、便携版误走常规路径,都会导致备份粘贴到错误位置。
唯一可靠方式是启动 Sublime Text 后,点击菜单:Preferences → Browse Packages…。弹出的窗口地址就是你要操作的真实路径:
- 若指向
Data\Packages→ 你在用便携版,所有配置都在同级Data文件夹里,别碰%APPDATA% - 若指向
%APPDATA%\Sublime Text\Packages(Windows)、~/Library/Application Support/Sublime Text/Packages(macOS)或~/.config/sublime-text-4/Packages(Linux)→ 这是常规版,按对应系统路径操作 - 注意大小写:便携版是
Data(大写 D),不是data;Linux 路径是sublime-text-4(短横线,非下划线)
备份哪些内容才真正有效
只拷 Packages/User 是最大误区。它只存配置开关和参数,不含插件逻辑本身。比如 SideBarEnhancements 的右键菜单、删除逻辑全在 Packages/SideBarEnhancements/ 里;只搬 User,新环境里按快捷键照样报错。
必须一起备份的三类内容:
-
Packages/User整个文件夹:含Preferences.sublime-settings、Default (Windows).sublime-keymap、Package Control.sublime-settings、各插件专属设置(如EmmyLua.sublime-settings) -
Packages/下所有非User的子目录:如GitGutter/、Dracula Color Scheme/、PackageResourceViewer/;跳过名字带~或.tmp的临时文件夹 - 配色方案文件本身(不是设置里的路径):例如
"color_scheme": "Packages/Dracula/Dracula.tmTheme",就得把Packages/Dracula/Dracula.tmTheme这个真实 XML 文件一起复制
便携版用户更简单:直接备份整个 Data 文件夹(含 Data\Packages 和 Data\Installed Packages),迁移时连同 sublime_text.exe 一起拷过去即可。
还原后为什么插件还是不生效
文件丢进目录 ≠ 配置立即生效。常见卡点有三个:
-
Package Control.sublime-settings里installed_packages字段为空或缺失 → 插件不会自动启用,手动补上列表或重装 Package Control - 配色方案路径写错:状态栏右下角执行
UI: Show Scope Name查当前实际路径,再核对Preferences.sublime-settings里color_scheme值是否完全匹配(包括大小写和斜杠方向) - 同步账号未登出:如果之前用过
subl --sync-login或菜单Preferences → Sync Settings → Login,重启后会从云端拉旧配置,覆盖本地还原结果;需先执行subl --sync-logout
验证是否成功:启动后按 Ctrl+Shift+P → 输入 Package Control: List Packages,看关键插件是否在列;再打开一个文件,检查快捷键和右键菜单是否响应正常。


















