sync settings插件需先确保package control正常且st版本≥3.0，安装后必须重启；setup时仅勾选gist权限并正确粘贴token，检查配置文件中gist_id和github_token非空；同步仅覆盖packages/user目录，无冲突解决机制，建议git备份。
Sync Settings安装后没菜单项？先验Package Control和ST版本
插件根本不会加载，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——能弹出搜索框才算OK。如果报错或无响应，重装Package Control（官网最新命令已适配ST4，别用旧脚本）。
- 安装时别手快选错：
Sync Settings (Deprecated)、SyncedSettings、SyncedSideBar都不是你要的插件 - Windows下用普通用户权限运行命令行装
Package Control，可能导致路径写入失败，需管理员身份重试 - 安装完必须重启Sublime Text，否则右键菜单和
Preferences里不会出现Sync Settings选项
Setup阶段token粘错位置，后续所有上传都静默失败
Sync Settings: Setup命令不会自动弹窗，也不会后台监听文件变化。一切从手动调出命令面板开始——输入并运行它，跳转到GitHub OAuth页后，只勾选gist权限。多勾repo或user不仅多余，还可能被企业账号策略拒绝，导致token创建失败。
token只显示一次，复制后必须立刻粘贴进Sublime弹出的输入框。误粘到浏览器地址栏、记事本或未加密笔记里，Packages/User/Sync Settings.sublime-settings里的github_token字段就是空的，后续Upload全会静默失败。
- 检查该配置文件，确认
"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/目录下的文件：.sublime-snippet放在Packages/Emmet/里？不会打包；Preferences.sublime-settings在Packages/Default/？也不会上传 - 所有配置文件必须手动放对位置，比如快捷键映射要存为
Packages/User/Default (Windows).sublime-keymap，主题配置要存为Packages/User/Preferences.sublime-settings - 公司内网或离线环境可启用
sync_local模式，完全绕过GitHub，用本地路径或NAS同步，避免网络依赖
同步是覆盖式，不是增量diff，远程少个文件本地就清空
Sync Settings同步的是整个Packages/User/目录内容，不是比对差异后只更新变动部分。远程Gist里漏掉一个SideBarEnhancements.sublime-settings，本地下次Download就会被清空——Sublime不报错，只是右键菜单突然消失、Ctrl+Shift+P搜不到对应命令。
它没有冲突解决机制，也不记录操作日志。如果你同时在两台机器上改配置又没及时Upload，大概率会丢文件。
- 建议搭配Git管理
Packages/User/目录，既能版本控制，又能避免覆盖风险 - 首次同步前，手动备份整个
Packages/User/目录，防止误操作不可逆丢失 - 多机协作时，务必约定“单点上传”，即只固定一台机器负责
Upload，其他机器只Download
