Sync Settings 插件需手动完成三步：token授权、首次上传、路径确认；必须通过Package Control安装；仅同步Packages/User/下文件；自动上传需配置"auto_upload": true。
Sync Settings 插件不是“安装完就自动同步”的开箱即用工具，它需要你手动完成 token 授权、首次上传、路径确认三步，缺一不可。直接双击安装或只执行 Install Package 不会触发任何同步行为。
怎么装？别跳过 Package Control 这一步
Sublime Text 本身不带包管理器，Sync Settings 必须通过 Package Control 安装——它不是独立可执行插件，而是依赖 Package Control 的生态链组件。
- 没装
Package Control？先按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Install Package Control，回车等待完成 - 再调出命令面板，输入
Package Control: Install Package，搜索并安装Sync Settings（注意名称是 Sync Settings，不是 SyncedSideBar 或 SyncedSettings） - 安装后不会弹窗、不会提示，必须手动运行后续命令才能激活
为什么 Setup 后没反应？token 权限和粘贴位置最关键
Sync Settings: Setup 命令会打开 GitHub OAuth 页面，授权后返回 Sublime 并生成一个 Personal Access Token。这个 token 决定你能写入哪个 Gist，也决定同步是否真正生效。
- 必须勾选
gist权限（仅此一项即可，不要多选；其他如repo或user属于过度授权） - token 只显示一次，复制后立刻粘贴进 Sublime 的输入框——不要粘贴到浏览器地址栏、不要保存在未加密笔记里
- 粘贴后回车，插件会把 token 写入
Packages/User/Sync Settings.sublime-settings，你可以打开该文件确认字段"github_token"是否存在且非空 - 如果 token 错误或过期，后续
Upload会静默失败，控制台（Ctrl+`）可能报401 Unauthorized
上传失败？检查 snippet 和配置是否真在 User 目录下
Sync Settings 只打包并上传 Packages/User/ 目录里的内容，它不扫描整个 Packages，也不读取插件自带的默认配置。
- 你的
.sublime-snippet文件必须手动放在Packages/User/下，比如Packages/User/log.sublime-snippet；如果它在Packages/Emmet/里，就不会被同步 - 快捷键、主题、设置等同理：只有
Packages/User/Preferences.sublime-settings、Key Bindings.sublime-keymap等才会被打包 - 执行
Sync Settings: Upload后，若提示Upload completed但 Gist 里看不到文件，大概率是gist_id字段为空——说明这是首次上传，插件会新建 Gist 并写入 ID；但如果网络中断或 token 失效，ID 就不会写入，下次上传仍会失败
自动同步怎么开？别信“上传一次就万事大吉”
默认关闭自动上传，每次修改设置后不会自动推送到 Gist。想省事，得手动改配置。
- 进入
Preferences → Package Settings → Sync Settings → Settings - 在右侧用户配置中添加：
{ "auto_upload": true } - 注意：
auto_upload是布尔值，不是字符串；写成"auto_upload": "true"会导致失效 - 启用后，每次保存
Preferences.sublime-settings或Key Bindings.sublime-keymap等受管文件时，插件会在后台触发上传——但不会通知你，需去 Gist 页面刷新确认
真正的难点不在安装，而在于理解它的同步边界：它不管插件二进制文件（Installed Packages/）、不碰项目级配置（.sublime-project）、不同步禁用插件的残留配置。你得清楚哪些东西它能托付，哪些还得靠 git 或软链接兜底。
