同步 Packages/User/ 是唯一靠谱的起点：所有个性化配置（界面偏好、快捷键、插件设置）均存于此，硬拷贝整个 Packages/ 会引入兼容性问题；应仅同步 User/ 文件夹，并通过符号链接或 Git 管理，配合 Package Control.sublime-settings 恢复插件。
同步 Packages/User/ 是唯一靠谱的起点
Sublime 的所有个性化配置——界面偏好、快捷键、插件设置——全存在 Packages/User/ 这个文件夹里，不是整个 Packages/，更不是 Installed Packages/。硬拷贝整个 Packages/ 会把插件源码、缓存（比如 Package Control.cache）、临时 session 文件一并拖过去，不同机器上 Python 环境或插件版本稍有差异，就可能报 ImportError: No module named 'package_control' 或菜单直接消失。
实操建议：
- 退出 Sublime Text，避免文件被锁
- 用 Finder / 文件资源管理器定位到你的
Packages/User/（路径见下一条） - 只同步这个文件夹本身，别带父级、别带隐藏缓存（如
.DS_Store、.cache） - 如果用云盘，把它挪进去后，再用符号链接指回来；如果用 Git，就只
git init这个User/目录
Windows/macOS/Linux 路径不统一，软链写法必须分平台
路径错一个字符，符号链接就失效，Sublime 启动后会安静地回退到默认配置——你改过的主题、字体大小、侧边栏宽度全没了，但不会报错提醒你。
常见路径（ST4 用户请把路径中的 3 换成 4）：
- Windows：
%APPDATA%\Sublime Text 3\Packages\User - macOS：
~/Library/Application Support/Sublime Text 3/Packages/User - Linux：
~/.config/sublime-text-3/Packages/User
对应软链命令：
- Windows（管理员权限 CMD）：
mklink /J "C:\Users\XXX\AppData\Roaming\Sublime Text 3\Packages\User" "D:\Sync\sublime-user" - macOS/Linux：
ln -s ~/Dropbox/sublime-user ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/User
注意：macOS 上 Application Support 和 Text 3 中的空格要转义，Linux 路径里不能有中文，否则 Sublime 可能加载失败。
插件本身不进同步目录，靠 Package Control.sublime-settings 恢复
插件代码体积大、含二进制依赖、版本更新频繁，放进 Git 或云盘只会拖慢同步、引发冲突。真正该同步的是记录“装了哪些插件”的清单文件：Packages/User/Package Control.sublime-settings。
它里面有个关键字段："installed_packages": ["AFileIcon", "BracketHighlighter", "SideBarEnhancements"]。只要这行在，新机器上启动 Sublime 后，Package Control 就会自动拉取列表里的插件。
实操要点：
- 确保新机器已安装 Package Control（按
Ctrl+Shift+P能唤出命令面板且搜到Package Control: Install Package） - 别手动复制
Installed Packages/下的 .sublime-package 文件——它们是压缩包，且 ST4 已弃用该格式 - 某些插件（如
Terminus）需要额外依赖（如ptyprocess），这类得单独处理，不在自动恢复范围内
别信“装完就同步”的插件，Sync Settings 必须手动走三步
Sync Settings 插件不是开箱即用的同步服务，它只是个上传/下载工具，跳过任意一步，就等于没装。
必须完成的三步：
- 获取 GitHub Token：进
Settings → Package Settings → Sync Settings → Settings，填入带gist权限的 token（ghp_...开头） - 首次上传：右键 →
Sync Settings: Upload，或命令面板执行，此时它才生成gist_id - 确认路径：检查插件设置里
"files": ["Preferences.sublime-settings", "Package Control.sublime-settings"]是否包含你要同步的文件
常见失败现象：
- 菜单项不出现 → Package Control 未正常加载，或插件版本不匹配（ST4 需 v3.0+）
- 上传卡住或报
requests错误 → Sublime 内置 Python 不含 requests，需手动补装，或干脆切到"mode": "local"用本地文件同步 - 快捷键失灵 → Windows 与 macOS 换行符不一致（CRLF vs LF），
.sublime-keymap解析失败，Git 提交前设core.autocrlf=input
最易被忽略的一点：同步不是实时的。改完设置后，你得主动 Upload，它不会监听文件变化自动推。所谓“同步”，其实是你手动触发的一次性快照。
