只同步Packages/User目录就足够了,因其集中存储所有用户配置文件(如Preferences.sublime-settings、Package Control.sublime-settings、平台快捷键文件、*.sublime-snippet及插件专属设置),关闭Sublime后完整复制即可秒级还原全部个性化配置;硬拷整个Packages目录会因混入插件源码和缓存导致ImportError或插件失效。

只同步 Packages/User 目录就足够了
新机器上不需要重装插件、不需手动导入设置——只要把旧机器的 Packages/User 文件夹完整复制过去,Sublime 就能识别所有偏好、快捷键、代码片段和插件开关状态。原因很简单:Preferences.sublime-settings 控制字体/缩进/主题;Package Control.sublime-settings 里的 installed_packages 列表会触发插件自动重装;Default (Windows).sublime-keymap 或对应平台文件定义全局快捷键;所有 *.sublime-snippet 和插件专属配置(如 SideBarEnhancements.sublime-settings)也都落在此处。
必须先关掉 Sublime,再操作文件
常见错误是边开着编辑器边复制粘贴,结果出现:插件菜单变灰、Ctrl+Shift+P 搜不到命令、控制台报 ImportError: No module named 'package_control'。这是因为 Sublime 运行时持续写入缓存与会话文件,强行覆盖会导致路径校验失败或 XML 解析静默跳过。
- Windows:任务管理器中确认所有
sublime_text.exe进程已结束(包括托盘残留) - macOS:活动监视器里 Force Quit
sublime_text,或终端执行killall sublime_text - Linux:用
ps aux | grep sublime找进程并kill - 验证方式:打开 Sublime → Preferences → Browse Packages…,弹窗应为空白或报错——说明进程真退出了
路径别硬记,用 Browse Packages… 确认真实位置
不同系统、ST 版本(3/4)、是否便携版,Packages/User 路径差异极大。写错空格、版本号、大小写,都会导致配置不生效。
- Windows 常规版:
%APPDATA%\Sublime Text 4\Packages\User(注意带空格,不是Sublime Text4) - macOS:
~/Library/Application\ Support/Sublime\ Text\ 4/Packages/User(终端中空格必须转义) - Linux:
~/.config/sublime-text-4/Packages/User(ST4 是sublime-text-4,不是sublime-text) - 便携版:
Data\Packages\User(大小写敏感,且在sublime_text.exe同级目录下) - 最准方法永远是:启动旧机器上的 Sublime → Preferences → Browse Packages…,地址栏路径就是你要复制的源位置
别碰 Installed Packages 和整个 Packages 目录
有人图省事直接拷整个 Packages,结果新机器上插件全失效、快捷键失灵、甚至启动报错。因为 Packages 里混着插件源码(如 GitGutter/)、本地缓存(Package Control.cache)、实时会话(Session.sublime_session),跨设备 Python 环境、换行符(CRLF vs LF)、插件版本稍有差异,就会触发加载拒绝。
-
Installed Packages/下的*.sublime-package是缓存,删了也没关系——只要Package Control.sublime-settings在User/里,重启后会自动重装 - 真正需要保留的是
Packages/下的插件解压目录(如Packages/SideBarEnhancements/),但这类目录通常已在旧机器上由 Package Control 自动解压;新机器只需确保User/中的installed_packages列表正确,它会自动拉取并解压 - 唯一要手动检查的是
color_scheme字段引用的配色文件(.tmTheme或.sublime-color-scheme),如果不在User/里,得单独找出来一并复制过去
最易被忽略的一点:同步完别急着开 Sublime。先检查新机器上 Package Control.sublime-settings 的 installed_packages 是否完整,再确认控制台(Ctrl+`)有没有报错——有些插件依赖本地 Python 模块或系统命令(比如 Git),这些没法靠同步解决,得单独装好环境再启用。











