只复制 Packages/User 目录即可完成 95% 配置迁移,因其包含 Preferences.sublime-settings、Package Control.sublime-settings、快捷键映射、构建系统及插件专属配置等全部关键文件;便携版应复制 Data 文件夹,常规版路径因系统而异,务必通过 Browse Packages… 确认真实路径,并彻底退出 Sublime 后再备份。

只复制 Packages/User 目录就能完成 95% 的配置迁移,其他路径全拷反而大概率导致插件失效、快捷键丢失或控制台报 ImportError。
为什么不能只备份 Preferences.sublime-settings?
这个文件只存编辑器基础设置(字体、缩进、主题路径等),但不包含:
-
Package Control.sublime-settings:漏掉它,插件不会自动重装,命令面板里搜不到任何插件命令 -
Default (Windows).sublime-keymap(或对应 macOS/Linux 文件):漏掉它,所有自定义快捷键失效 -
MyBuild.sublime-build或其它构建系统:漏掉就无法运行自定义编译流程 -
EmmyLua.sublime-settings等插件专属配置:漏掉后插件行为退回到默认状态,比如 Lua 补全失效
这些文件全在 Packages/User 下,一个都不能少。别用资源管理器进去只勾选几个文件——直接复制整个 User 文件夹。
便携版和常规版的路径根本不是一回事
便携版的配置全在程序同级的 Data 文件夹(注意大小写:大写 D + 小写 ata),常规版则分散在系统配置目录中。硬套路径必错:
- Windows 常规版真实路径是
%APPDATA%\Sublime Text\Packages,不是安装目录下的Packages - macOS 路径含空格:
~/Library/Application Support/Sublime Text/Packages,终端里必须写成Application\ Support - Linux 用户注意 ST3/ST4 差异:
sublime-text-3和sublime-text(ST4)是两个独立目录,混用会加载失败 - 便携版用户完全不用管上面那些——关掉 Sublime 后,直接复制整个
Data文件夹即可
最准的方法永远是:启动 Sublime → Preferences → Browse Packages…,弹出窗口地址就是你要操作的真实位置。
备份前不彻底退出 Sublime,备份就等于白做
Sublime 运行时会持续写入 Packages 和 Installed Packages 目录,边复制边写极易产生损坏:
- 出现带
~或.tmp的残骸文件 -
Preferences.sublime-settings被重置为默认值 - 插件目录结构错乱,重启后报
reloading plugin XXX failed
务必确认进程已完全退出:
- Windows:打开任务管理器,结束所有
subl.exe进程 - macOS:Dock 右键 Sublime 图标 →
Quit Sublime Text(不是关窗口),再检查活动监视器里有没有sublime_text - Linux:终端执行
pkill -f "subl"或kill $(pgrep -f "sublime_text")
托盘图标还在 ≠ 进程已退出。多花 10 秒确认,能省去后续两小时排查。
配色方案和插件主题容易被忽略
Preferences.sublime-settings 里的 "color_scheme": "Packages/Dracula Color Scheme/Dracula.tmTheme" 只是一条路径引用,不是文件本身:
- 如果插件是通过
.sublime-package安装的(比如 Dracula Color Scheme.sublime-package),需手动改后缀为.zip解压,提取其中的.tmTheme或.sublime-color-scheme文件 - 有些新主题用的是
.sublime-color-scheme(JSON 格式),优先级高于.tmTheme,也得一并拷走 - 插件依赖的子模块(如
sublime_lib)不会随主插件自动安装,若控制台报ImportError: No module named 'sublime_lib',说明你只拷了主插件目录,没处理依赖
验证是否完整:迁移后启动 Sublime,按 Ctrl+Shift+P 输入 Color Scheme,看能否正常切换;再输入插件名,确认命令存在且可执行。


















