最稳妥方法是通过preferences → browse packages…打开目录,再进入user子文件夹;windows路径为%appdata%\sublime text\packages\user,macos为~/library/application support/sublime text/packages/user,linux为~/.config/sublime-text/packages/user,便携版则在安装目录下data\packages\user。

Sublime Text 没有“一键迁移”功能,所谓“全套配置”必须手动复制特定目录——错一个路径、漏一个文件、多一个缓存,迁移后就大概率出现插件不加载、主题失效、快捷键失灵等问题。
怎么找对 Packages/User 目录?路径因系统和便携版而异
所有你改过的设置、快捷键、构建系统、插件开关状态,都明明白白存在 Packages/User 文件夹里。但它的物理位置不是固定的:
- Windows:
%APPDATA%\Sublime Text\Packages\User(ST4 用户注意把Text后面的空格保留,别写成Text4) - macOS:
~/Library/Application Support/Sublime Text/Packages/User(注意Application Support中的空格要转义,终端里写成Application\ Support) - Linux:
~/.config/sublime-text/Packages/User(ST4 是sublime-text-4) - 便携版:直接看程序同级的
Data\Packages\User(注意大小写,是Data,不是data或DATA)
最稳妥的验证方式:菜单 → Preferences → Browse Packages…,弹出窗口的路径必须和你准备操作的路径完全一致。如果指向别的位置,说明你当前用的是便携版却按常规版路径去翻,或者被符号链接绕晕了。
只备份这三个东西,覆盖 95% 迁移场景
别整个 Packages 文件夹全选复制——里面混着缓存、临时生成的文件夹(比如 PackageResourceViewer 自动生成的),它们不参与配置,还可能干扰恢复。
-
User文件夹:必须整份拷。它含Preferences.sublime-settings、Preferences.sublime-keymap、Package Control.sublime-settings,还有各插件的xxx.sublime-settings(如EmmyLua.sublime-settings) - 插件源码目录:只复制
Packages/下非User的子目录,比如GitGutter、SideBarEnhancements。这些是解压后的源码,能直接加载 - 配色方案文件(
.tmTheme或.sublime-color-scheme):不是设置里的 JSON 路径,而是真实文件。从状态栏右下角执行 UI: Show Scope Name 看路径,例如Packages/Dracula/Dracula.tmTheme,按路径找到并复制该文件
不用管 Installed Packages 目录下的 .sublime-package 文件——那是 Package Control 的下载缓存,删了重启会重装;但它的存在不代表插件当前启用,不能作为备份依据。
迁移后插件不显示?常见失效原因和验证动作
把文件拷过去重启,发现插件没加载、主题没出现、快捷键失灵——大概率不是备份错了,而是没触发刷新或路径卡住。
- 重启后立刻执行 Preferences → Browse Packages…,确认路径是否仍指向你刚粘贴的目录(尤其便携版,若误放成常规版路径,Sublime 会悄悄回退到默认位置)
- 按
Ctrl+Shift+P→ 输入Package Control: List Packages,看看插件列表是否完整;如果空白,说明Package Control.sublime-settings没生效或插件目录没放对位置 - 检查
Packages/Package Control/是否存在且非空——如果不存在,首次启动时 Package Control 会重建,但重建的版本可能和你原来用的不一致(尤其你之前手动改过源码或用了 fork 分支) - 某些插件(如通过
git clone安装的)需要连.git文件夹一起备份,否则重装后无法git pull更新
Backup 目录里的文件不能直接用,必须重命名才能恢复
Sublime 的 Backup 目录(路径类似 ~/Library/Application Support/Sublime Text/Backup/)只存带时间戳的只读快照,比如 Preferences.sublime-settings-2024-05-12-14-22-08。这类文件不会被自动加载。
- 必须手动重命名为标准名,如
Preferences.sublime-settings,不能保留任何后缀或时间戳 - 目标位置是
Packages/User/,不是Backup/本身 - 恢复前建议先备份当前
Preferences.sublime-settings(如果还存在),再覆盖 - 恢复后务必重启 Sublime,且禁用同步工具(如 Syncthing、Dropbox)干扰——它们可能在你操作时覆盖刚恢复的文件
真正容易被忽略的是:Sublime 的 Backup 功能默认只对 Packages/User/ 下的文件生效,且依赖于「正常退出」——异常崩溃或强制 kill 可能导致某次修改根本没进 Backup。所以定期导出配置(Preferences → Package Settings → Sync Settings → Backup)比依赖自动备份更可靠。











