Sync Settings 插件需手动完成token授权、首次上传、路径确认三步才能同步，安装后无自动流程；它仅同步Packages/User/下文件，不监听变化，失败常因token错误、gist_id未写入或权限配置不当。
Sync Settings 插件不是“装完就能同步”的工具，它必须手动完成三步：token 授权、首次上传、路径确认。跳过任意一步，同步就完全不会发生。
为什么 Sync Settings 安装后没反应？
因为插件本身不自动启动任何流程——它没有后台服务，也不监听文件变化。安装只是把代码放进 Packages/ 目录，后续所有动作都靠你手动触发命令面板里的指令。
- 没装
Package Control？先按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Install Package Control回车；等几秒后再执行Package Control: Install Package，搜Sync Settings（注意不是SyncedSettings或SyncedSideBar） -
Sync Settings: Setup命令会跳转到 GitHub OAuth 页面，**必须勾选gist权限**（其他如repo属于过度授权，且可能被拒绝） - token 只显示一次，复制后立刻粘贴进 Sublime 的输入框——不要粘到浏览器地址栏，也不要存进未加密的笔记软件；粘错或漏粘，
Packages/User/Sync Settings.sublime-settings里github_token字段就是空的，后续所有上传都会静默失败
Sync Settings: Upload 成功但 Gist 里看不到文件？
这是最常被忽略的“假成功”现象：提示 Upload completed 并不代表内容真传上去了——它只表示打包和 HTTP 请求发出去了。如果 token 失效、网络中断或 gist 创建失败，gist_id 就不会写入配置文件，下次上传仍会新建一个 Gist，旧的永远找不到。
- 检查
Packages/User/Sync Settings.sublime-settings是否含非空gist_id字段；没有就说明首次上传没真正落地 - 插件只同步
Packages/User/下的文件，.sublime-snippet放在Packages/Emmet/里？不会被打包；Preferences.sublime-settings在Packages/Default/？也不会上传 - 控制台（
Ctrl+`）若报401 Unauthorized，基本可确定是 token 错误或过期，需重新Setup
为什么建议用 Git 替代 Sync Settings？
它本质是全量覆盖式同步，不是增量更新。远程 Gist 里少了一个插件的配置文件（比如 SideBarEnhancements.sublime-settings），下次同步就会把本地这个文件清空——Sublime 不报错，只是右键菜单突然消失，Ctrl+Shift+P 搜不到命令。
- Git 能看到每次改了哪一行设置，能
git revert回滚，也能git diff确认是否真同步对了 - 不同系统快捷键冲突？可以拆成
keymap-macos.json和keymap-win.json，再用软链接或启动脚本切换，Sync Settings做不到这种粒度 - Windows 上用 WSL clone 的仓库，再用原生 Sublime 打开，可能因换行符或权限出错；macOS 上若用
sudo git，文件属主变成root，Sublime 启动时无法写入——这些坑，Sync Settings不提醒，Git 至少让你看见git status -u
符号链接 + 云盘是最省心的折中方案
如果你不想碰 Git 命令，又怕 Sync Settings 失效导致配置丢失，直接把 Packages/User/ 文件夹软链到 Dropbox / OneDrive / 坚果云里，是目前最稳定、最透明的同步方式。
- macOS/Linux：先退出 Sublime，运行
ln -s ~/Dropbox/SublimeText/User ~/Library/Application\ Support/Sublime\ Text/Packages/User - Windows：管理员权限打开 CMD，运行
mklink /D "%APPDATA%\Sublime Text\Packages\User" "C:\Users\YourName\Dropbox\SublimeText\User" - 注意路径一致性：新版 Sublime 已统一为
Sublime Text（不是Sublime Text 3或4），路径写错会导致链接失效，Sublime 自动创建空User目录，云盘同步就断了
Sync Settings 把这件事藏在黑盒里，Git 和符号链接则把每一步暴露出来——你得亲手 git add & commit & push，或者亲眼确认云盘状态图标变成“已同步”。没人替你兜底，但也没人偷偷覆盖你的配置。 
