sync settings插件安装后无菜单项，先确认package control已正常工作且sublime text版本兼容（st3或st4≥v3.0），再检查是否误装deprecated版本或未重启编辑器。
Sync Settings 插件安装后没菜单项？先查 Package Control 和版本兼容性
装完 Sync Settings 却在 Preferences 里找不到选项，基本不是插件问题，而是前置条件没满足。它必须依赖 Package Control 运行，且只支持 Sublime Text 3 和 ST4 v3.0+（ST4 低于 v3.0 的版本会静默失败）。
验证方式：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package 能执行并弹出列表才算 OK。如果不能，先装 Package Control；如果能但搜不到 Sync Settings，检查 ST 版本——Help → About 里看是否为 Build 41xx 且内核 ≥ v3.0。
常见误操作：
- 手快点错成
SyncedSettings或SyncedSideBar，这两个是不同插件，不提供同步功能 - 安装时 Sublime 正在运行旧版插件缓存，需重启后再试
- Windows 下未以管理员身份运行命令行，导致
Package Control安装路径权限不足
上传成功但 Gist 里空空如也？gist_id 没写入是主因
Sync Settings: Upload 显示 “Upload completed” 不代表配置真上去了。这个提示只表示 HTTP 请求发出了，但若 token 失效、网络中断或 GitHub 返回 403/422，gist_id 字段就不会写进 Packages/User/Sync Settings.sublime-settings。下次再传，它又建新 Gist，旧的永远找不回。
自查方法：打开 Packages/User/Sync Settings.sublime-settings，确认里面有非空的 "gist_id": "xxx" 和 "github_token": "ghp_..."。没有？说明 Sync Settings: Setup 阶段 token 粘贴失败或权限没勾选 gist。
关键细节：
- GitHub OAuth 页面中，
gist权限必须勾选，repo或user属于过度授权，某些企业账号会被拒绝 - token 只显示一次，复制后**立刻粘贴到 Sublime 弹出的输入框**，别误粘到浏览器地址栏或记事本
- 控制台报
401 Unauthorized，基本可断定 token 错或过期，需重新Setup
为什么右键菜单突然消失、快捷键失效？Sync Settings 是覆盖式同步
Sync Settings 同步的是整个 Packages/User/ 目录内容，不是增量 diff。远程 Gist 里少了一个文件（比如 SideBarEnhancements.sublime-settings），本地下次同步就会被清空——Sublime 不报错，只是对应插件的功能直接不可用。
它不监听文件变化，也不做冲突合并。两台电脑同时改了同一份 Preferences.sublime-settings，后上传者会完全覆盖前者，中间修改丢失。
安全做法：
- 首次上传前，手动检查
Packages/User/下所有文件是否齐全：主题、keymap、snippets、插件配置都得放这儿 - 避免把插件自带的默认配置（如
Packages/Emmet/keymaps/Default (Windows).sublime-keymap）误当用户配置同步——这些不该放User目录 - 想保留平台差异？
Key Bindings.sublime-keymap里可用"platforms": ["windows"]字段限定，但Sync Settings不解析该逻辑，得靠人工维护多份
token 泄露风险和 Gist 大小限制必须正视
你的 github_token 是私钥级凭证，一旦泄露，攻击者能读写你所有 Gist，包括可能存在的 API key、密钥片段等敏感内容。而 Sync Settings 默认把整个 User 目录打包上传，里面很可能混着 .env 片段、数据库连接串、甚至临时调试用的硬编码密码。
Gist 本身有 1MB 文件大小上限，Packages/User/ 超过这个值就上传失败，且插件不会提示具体哪部分超限——只能手动删掉大体积的 snippet 或日志类文件再试。
更现实的问题：
- 公司防火墙屏蔽 GitHub API，
Sync Settings会卡在 upload 步骤，连错误都不报，只在控制台显示 timeout - 换电脑重装后，
Sync Settings: Download会覆盖本地全部User内容，包括你刚调好的新主题配色，无法选择性恢复 - macOS 上用
sudo git管理过配置，文件属主变成root，Sublime 启动时无法写入User/，同步后反而导致崩溃
