直接备份整个Packages目录(不含Cache和临时文件)并关闭Sublime Text后操作,是唯一能100%还原插件功能、快捷键、主题和构建系统的方法;必须通过Preferences→Browse Packages…确认真实路径,再完整复制User文件夹、所有非User插件子目录及.tmTheme配色文件。

直接备份整个 Packages 目录(不含 Cache 和临时文件)+ 关闭 Sublime Text 后操作,是唯一能 100% 还原插件功能、快捷键、主题和构建系统的做法。只拷 User/ 文件夹,90% 的插件会“消失”或报 command not found。
怎么找对 Packages 目录的真实路径?别猜,用菜单确认
硬记 %APPDATA% 或 ~/Library/Application Support 极易出错——macOS 路径含空格需转义,Linux 区分 sublime-text-3 和 sublime-text-4,便携版压根不用这些路径。最准的方式永远是:
- 启动 Sublime Text →
Preferences→Browse Packages… - 弹出的窗口地址就是你该操作的真实位置
- 如果指向
DataPackages,说明你在用便携版,别去翻%APPDATA%
备份哪些东西?三类必须全齐,缺一不可
只备份 User/ 是最大误区。插件逻辑不在里面,它只是“开关”和“参数”。真正执行命令的是插件自己的目录,比如 SideBarEnhancements/ 或 GitGutter/。要还原完整行为,得一起搬:
-
User/整个文件夹:含Preferences.sublime-settings、Default (Windows).sublime-keymap、Package Control.sublime-settings、各插件专属配置(如EmmyLua.sublime-settings) -
Packages/下所有非User的子目录:如GitGutter/、Dracula Color Scheme/、PackageResourceViewer/—— 注意跳过名字带~或.tmp的临时文件夹 - 配色文件本身(
.tmTheme):不是设置里写的路径名,而是真实 XML 文件,例如Packages/Dracula/Dracula.tmTheme;从状态栏右下角执行UI: Show Scope Name可查到准确路径
为什么不能跳过关闭 Sublime Text 这一步?
Sublime 在运行时会锁住 Installed Packages/ 中的 .sublime-package 文件,并持续热重载 Packages/ 下的插件目录。边复制边写入会导致:
- 插件目录损坏(比如
GitGutter/缺少git_gutter.py) - 出现残留的
~或.tmp文件夹,干扰恢复 - 迁移后某些插件菜单空白、右键无响应、快捷键失效
务必在任务管理器(Windows)、活动监视器(macOS)或 ps aux | grep sublime(Linux)中确认 subl 或 sublime_text 进程已彻底消失——macOS 用户尤其注意:必须点菜单 Sublime Text → Quit Sublime Text,关窗口不算数。
同步到另一台电脑后,最容易被忽略的三件事
文件丢进去 ≠ 配置就生效。环境不一致时,很多问题不会报错,但功能就是不对:
- 检查
Package Control是否可用:按ctrl+shift+p看命令面板是否弹出;若无反应,进Preferences → Package Settings → Package Control → Settings – User确认内容非空且格式合法 - 验证配色是否真加载:状态栏右下角点击当前主题名,看路径是否指向你备份的那个
.tmTheme文件,而不是默认的Monokai.tmTheme - 留意路径含中文或空格的插件:比如自定义
.sublime-build里写了"cmd": ["C:\我的工具\build.bat"],迁移后路径不存在就会静默失败


















