Sync Settings插件装上不等于能用，必须手动执行Setup并确认gist_id写入Packages/User/Sync Settings.sublime-settings成功才生效；它仅同步Packages/User/下文件，Setup失败主因是Package Control未就绪、GitHub OAuth授权未完成或token粘贴错误。
Sync Settings 插件装上不等于能用，它必须手动执行 Setup 并确认 gist_id 写入成功才算生效。
Sync Settings 安装前必须验证 Package Control
插件安装失败的根源，90% 出在 Package Control 没跑通。按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package —— 如果没弹出搜索框，说明 Package Control 根本没加载。
- 别跳过这步：先确保
Package Control: Install Package可用，再搜Sync Settings（注意不是Sync Settings (Deprecated)） - 如果控制台报
No module named 'package_control'，大概率是缓存损坏，需重装 Package Control（官网最新安装命令已适配 ST4） - Windows 用户若用便携版，
Installed Packages路径不在%APPDATA%，而是在Data\Installed Packages下，路径错会导致插件不加载
Setup 失败的三个高频原因
执行 Sync Settings: Setup 后卡住、没反应、或配置文件里 github_token 为空，基本锁定以下三点：
- GitHub OAuth 授权未完成：跳转页面后只勾
gist权限，其他全取消；token 只显示一次，复制后必须立刻粘贴进 Sublime 的输入框并回车 - token 粘错位置：比如误粘到浏览器地址栏、记事本、或带格式的富文本编辑器里，导致隐藏字符混入，
github_token字段实际为空 - 网络受限时 requests 模块缺失：公司内网或某些 Linux 发行版默认没装
requests，可临时改用sync_local模式绕过所有网络依赖
Upload completed 却找不到 Gist 文件？
这是最典型的“假成功”——HTTP 响应码 200，但 gist_id 没写进 Packages/User/Sync Settings.sublime-settings，意味着上传根本没落地。
- 上传后立刻打开该配置文件，检查
"gist_id": "xxxxxx"是否为非空字符串；为空 = 失败，下次Sync Settings: Upload会新建一个 Gist，旧的永远丢失 - 控制台报
401 Unauthorized，基本就是 token 错误或过期，必须重新执行Sync Settings: Setup - 同步范围严格限定在
Packages/User/下：.sublime-snippet 必须放在这里才有效；Preferences.sublime-settings放对了才管用；插件自带的默认配置（如Packages/Default/Preferences.sublime-settings）永远不会上传
比 Sync Settings 更稳的替代方案
它本质是全量覆盖式同步，不记录变更、不支持冲突合并、不区分平台路径，遇到多设备同时修改或 macOS/Windows 键位混用，很容易覆盖或失效。
- 符号链接 + 云盘（Dropbox/OneDrive）是最轻量实时的方案：把
Packages/User移到云盘，再在原位置建软链，改完几秒同步，且无 token、无 gist、无权限问题 - Git 管理适合需要版本回溯的人：只 commit
User/下那三类文件（*.sublime-settings、*.sublime-keymap、*.sublime-snippet），避免提交缓存、session 或跨平台换行符污染 - 千万别硬拷整个
Packages/目录：里面混着插件源码、Python 缓存、Session 文件，不同机器 Python 版本或换行符稍有差异，就会触发插件消失、菜单变灰、Tab 不展开片段等静默故障
