Sync Settings插件不可靠，无法实现完整跨设备云同步；它仅同步Packages/User/下文件，存在上传静默失败、gist_id未写入、token过期无提示、平台快捷键冲突等问题，且不支持回滚，推荐改用符号链接+云盘或Git手动同步。
Sync Settings 插件不能实现可靠、完整的跨设备云同步，尤其不推荐用于主力开发环境。 它只同步 Packages/User/ 下的文件，但上传失败静默、gist_id 不写入、token 过期无提示、平台快捷键文件名冲突（Default (Windows).sublime-keymap vs Default (OSX).sublime-keymap）等问题高频发生，且无法回滚或排查差异。
Sync Settings 安装后没菜单、不响应命令？
这不是插件坏了，而是它根本没被激活——安装只是复制代码，后续三步缺一不可：
- 必须先确保
Package Control正常：按Ctrl+Shift+P输入Package Control: Install Package能执行成功 - 再执行
Package Control: Install Package→ 搜索并安装Sync Settings（注意不是SyncedSettings或带Deprecated后缀的） - 重启 Sublime Text 后，手动调出命令面板，运行
Sync Settings: Setup—— 这一步跳转 GitHub OAuth 页面，必须勾选gist权限，token 复制后立刻粘贴进 Sublime 输入框，**粘错或漏粘会导致github_token字段为空，后续所有操作静默失败**
Upload completed 却找不到配置？
这是典型“假成功”：提示上传完成，不代表内容真到了 Gist。常见原因：
-
Packages/User/Sync Settings.sublime-settings中gist_id字段为空或为""—— 说明首次上传因网络中断、token 失效或权限不足而未真正创建 Gist - 控制台（
Ctrl+`）报401 Unauthorized，基本可确认 token 错误或已过期，需重新运行Sync Settings: Setup - 你改了
Preferences.sublime-settings，但把它放在了Packages/Default/或其他非User/目录下 ——Sync Settings只打包Packages/User/内的文件，其余一概忽略
为什么同步后快捷键失效、插件菜单变灰？
本质是同步范围失控 + 平台不兼容：
- 它不区分平台，把
Default (Windows).sublime-keymap直接覆盖到 macOS 上，导致快捷键解析失败（Sublime 不报错，只是全部失灵） - 同步了
Session.sublime_session或Local/目录 —— 这些是本地运行时状态，跨设备加载会触发ImportError: No module named 'package_control'或插件白屏 - 用网盘同步时多设备同时编辑同一
.sublime-snippet，产生.sync-conflict文件，Sublime 直接跳过加载，无任何提示
真正稳定的方案是放弃 Sync Settings，改用符号链接 + Dropbox/坚果云，严格锁定 Packages/User/ 目录，并确保每次操作前退出 Sublime、删除原目录、用 mklink /J（Windows 管理员 CMD）或 ln -s（macOS/Linux）重建链接。Git 方案更可控，但需手动 git add && git commit && git push —— 自动化不是默认选项，而是要你明确决定何时同步什么。
