packages/user 是完整配置的唯一来源,因其包含所有个性化设置文件如preferences.sublime-settings、preferences.sublime-keymap、package control.sublime-settings、构建系统及主题文件,删则清零、复制即可100%还原。

怎么确认 Packages/User 是完整配置的唯一来源
Sublime Text 没有“配置导出”功能,所有个性化设置——包括快捷键、插件启用状态、构建系统、主题路径、甚至缩进偏好——都明文存放在 Packages/User 目录下。这不是一个选项,而是事实:删掉它,你所有的自定义就清零;复制它,就能 100% 还原。
常见错误是只复制 Preferences.sublime-settings,结果发现插件没开、快捷键失灵、构建任务消失。因为:
-
Preferences.sublime-keymap存着你改过的快捷键 -
Package Control.sublime-settings记录了已安装插件和禁用列表 -
MyBuild.sublime-build或类似文件才是你手动写的构建系统 - 配色方案(如
"color_scheme": "Packages/Dracula Color Scheme/Dracula.tmTheme")指向的.tmTheme或.sublime-color-scheme文件必须一并拷贝,否则主题不生效
迁移前必须关掉 Sublime Text
Sublime 在运行时会持续写入 Packages/User,尤其是自动补全缓存、临时 session 文件、甚至可能覆盖你正在复制的 Preferences.sublime-settings。一旦你看到新电脑上配置“部分生效”,大概率是旧进程在后台偷偷重写了文件。
操作前请确认:
- Windows/macOS/Linux 任务管理器或活动监视器里没有
subl或Sublime Text进程 - 便携版用户注意:关闭后检查
Data/Packages/User(不是data,首字母大写) - 别依赖“退出”菜单——直接右上角 × 或
Cmd+Q/Ctrl+Q强退
路径不对是失败最常见原因
别靠记忆或网上搜到的路径硬写,Sublime 自己就知道在哪。打开任意 Sublime 窗口,点 Preferences → Browse Packages…,弹出的文件夹就是真实 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(Data必须大写,且位于解压根目录下)
符号链接、OneDrive 同步目录、WSL 路径映射都容易导致路径错位,用 Browse Packages… 是唯一可靠方式。
导入后重启才真正生效
复制完 Packages/User 到目标机器后,直接双击启动 Sublime 不会加载新配置。必须完全退出再重新打开——不是“关闭窗口”,是彻底终止进程。
特别注意:
- 插件(如
PrettyLua)依赖的二进制路径(如"binary": "E:/project/tools/stylua")在新机器上大概率失效,需手动更新Packages/User/PrettyLua.sublime-settings - 如果用了自定义主题但没把
.tmTheme或.sublime-color-scheme文件一起拷过来,color_scheme设置会回退到默认 - 快捷键冲突(比如
Ctrl+Alt+A和 QQ 截图)不会自动规避,得自己去Preferences.sublime-keymap里调
配置迁移本身很简单,麻烦的是那些藏在路径、权限、进程状态里的细节。少一次“我以为没问题”,多一次 Browse Packages… 验证,就能省掉半天排查时间。











