Sync Settings插件装不上，先确认Package Control已安装且Sublime Text版本≥3.0；安装后必须重启，Setup时仅勾选GitHub gist权限并正确粘贴token，确保配置文件中gist_id和github_token非空。
Sync Settings 插件装不上？先确认 Package Control 和 ST 版本
Sync Settings 插件根本不会出现在命令面板里，90% 是因为前置条件没满足。它依赖 Package Control 启动，且只支持 Sublime Text 3 或 ST4 ≥ v3.0（2026 年主流版本基本达标，但旧 Build 如 4143 以下可能静默失败）。
验证方式：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package —— 能弹出搜索框才算正常。如果报错或无响应，重装 Package Control（官网最新安装脚本已适配 ST4，别用旧版）。
- Windows 下用普通用户权限运行命令行安装
Package Control，可能导致路径写入失败，需改用管理员 CMD 重试 - 安装完必须重启 Sublime Text，否则右键菜单和
Preferences里不会出现Sync Settings选项 - 别手快选错插件：
Sync Settings (Deprecated)、SyncedSettings、SyncedSideBar都不是你要的
Setup 失败？token 没粘对位置是主因
Sync Settings: Setup 命令不会自动弹窗，也不会监听文件变化。一切从手动调出命令面板开始——输入并运行它，跳转到 GitHub OAuth 页面后，**只勾选 gist 权限**。多勾 repo 或 user 不仅多余，还可能被企业账号策略拒绝。
token 只显示一次，复制后必须立刻粘贴进 Sublime 弹出的输入框。误粘到浏览器地址栏、记事本或未加密笔记里，Packages/User/Sync Settings.sublime-settings 中的 github_token 字段就是空的，后续所有 Upload 都会静默失败。
- 打开
Packages/User/Sync Settings.sublime-settings，确认"gist_id": "xxx"和"github_token": "ghp_"都是非空字符串，才算真正落地 - 控制台（
Ctrl+`）若报401 Unauthorized，基本锁定为 token 错误或过期，需重新执行Sync Settings: Setup - GitHub OAuth 页上，
gist权限是唯一必需项；其他权限属于过度授权，且可能触发组织级拦截
Upload completed ≠ 同步成功，gist_id 为空=白传
控制台显示 Upload completed 极具迷惑性——它只表示 HTTP 请求发出去了，不代表 Gist 创建成功、内容写入成功。网络中断、token 失效或 GitHub 返回 403/422 时，gist_id 字段就不会写入配置文件。
下次再执行 Sync Settings: Upload，插件会新建一个 Gist，旧的永远找不回。自查方法：打开 Packages/User/Sync Settings.sublime-settings，看 gist_id 是否有值。没有就等于没同步成功，不是“上传完了”，是“上传失败了但没告诉你”。
- 该插件只同步
Packages/User/目录，不处理color_scheme引用的.tmTheme或.sublime-color-scheme文件，这些得手动找出来一并上传到 Gist - 它没有冲突解决机制，多端同时修改再上传，后一次会直接覆盖前一次，建议搭配 Git 做本地备份
- 换新电脑首次恢复时，要先装好
Package Control，再运行Sync Settings: Download，否则installed_packages列表不会触发自动安装
更稳的替代方案：符号链接 + 云盘，比插件更可靠
Sync Settings 本质是把 Packages/User/ 打包上传到 Gist，靠 HTTP 轮询拉取，延迟高、易失败、无本地历史。而符号链接是把云盘里的 User 目录“挂载”到 Sublime 原读取路径，改一处，几秒内另一台设备就能看到，不依赖插件、不走网络请求、不卡在 OAuth 流程里。
操作前必须完全退出 Sublime Text，否则文件被锁，链接创建失败或后续不同步。删除原 User 目录（不是重命名），再建链接：
- macOS/Linux 终端：
ln -s ~/Dropbox/SublimeConfig/User ~/Library/Application\ Support/Sublime\ Text\ 4/Packages/User - Windows 管理员 CMD：
mklink /J "C:\Users\用户名\AppData\Roaming\Sublime Text 4\Packages\User" "D:\Dropbox\SublimeConfig\User" - iCloud 和 OneDrive 对
~/Library或%APPDATA%同步支持不稳定，Dropbox 或坚果云更可靠
真正容易被忽略的是：所有你手动改过的配置都明文落在 Packages/User/ 下，包括 Preferences.sublime-settings、Package Control.sublime-settings（含 installed_packages 列表）、快捷键文件、.sublime-snippet，以及各插件自己的 .sublime-settings。但 color_scheme 字段引用的配色文件不在这个目录里，得单独拎出来放进云盘同一层级——漏掉它，主题就变回默认灰色。
