sync settings在sublime text 4上可用，但必须手动完成三步：package control正常、sync settings: setup成功触发、gist_id写入配置；跳过任意一步同步即失效。
Sync Settings 插件在 Sublime Text 4 上能用，但必须手动完成三步：Package Control 正常、Sync Settings: Setup 成功触发、gist_id 写入配置文件；跳过任意一步，同步就完全不会发生。
Package Control 没跑通，Sync Settings 根本不加载
插件依赖 Package Control 启动，不是“装完就出现”。先验证它是否真在工作：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package—— 能弹出搜索框才算 OK - 若报错或无响应，说明 Package Control 损坏或未安装，此时别搜 Sync Settings，先重装 Package Control（2026 年官网脚本已适配 ST4，旧版哈希校验失败的脚本别用）
- 确认成功后，再执行
Package Control: Install Package→ 输入Sync Settings→ 回车（注意别选Sync Settings (Deprecated)）
Setup 失败或 token 粘贴错位，后续所有上传都静默失败
Sync Settings: Setup 必须手动触发，且只显示一次 token。常见问题不是 GitHub 登录失败，而是 token 没真正落进配置：
- token 必须带
gist权限（其他如repo属于过度授权，可能被拒绝） - token 只显示一次，复制后立刻粘贴进 Sublime 的输入框；若误粘到浏览器地址栏或文本编辑器里，
Packages/User/Sync Settings.sublime-settings中的github_token字段就是空的 - 上传后务必打开
Packages/User/Sync Settings.sublime-settings，确认gist_id和access_token都是非空字符串——为空？说明这次上传没真正落库，下次Upload会新建一个 Gist，旧的再也找不回来
Upload completed 不等于同步成功，gist_id 未写入是最大陷阱
控制台显示 Upload completed 很有迷惑性，它只表示 HTTP 请求发出去了，不代表 Gist 创建成功、内容写入成功：
- 常见失败原因：token 过期/错误、网络中断、GitHub gist 服务临时不可用
- 若控制台报
401 Unauthorized，基本锁定为 token 问题，需重新执行Sync Settings: Setup - 插件只同步
Packages/User/下的文件：.sublime-snippet放在Packages/Emmet/？不会打包；Preferences.sublime-settings在Packages/Default/？也不会上传
公司内网或离线环境直接用 sync_local 模式
如果机器无法访问 GitHub（比如企业防火墙、机场 Wi-Fi 限制、或你单纯不想把配置上传云端），Sync Settings 内置了纯本地模式，零网络依赖：
- 无需 token，无需 gist，不发任何 HTTP 请求
- 所有同步操作只读写本地
Packages/User/目录下的文件，适合备份到 NAS、Git 仓库或 USB 设备 - 启用方式：在
Packages/User/Sync Settings.sublime-settings中设置"mode": "sync_local"，然后用Sync Settings: Upload和Sync Settings: Download即可
最易被忽略的是：它本质是全量覆盖式同步，不是增量更新。远程 gist 里少了一个插件的配置文件（比如 SideBarEnhancements.sublime-settings），下次同步就会把本地这个文件清空——Sublime 不报错，只是右键菜单突然消失，Ctrl+Shift+P 搜不到命令。这点在多机长期使用后尤其危险。
