sync-settings 插件需同时配置 github token（含 gist 权限）和 secret gist id 才能工作，二者缺一不可；备份与恢复均为手动触发的快照操作，不自动同步；插件列表仅记录不安装，恢复时依赖 apm 网络拉取；token 和 gist id 需定期维护以防失效。
sync-settings 插件必须配 GitHub Token 和 Gist ID 才能工作
Atom 本身不带云端同步能力，sync-settings 是靠 GitHub Gist 存配置的——不是“登录就能用”，而是必须手动提供两个凭证：Personal Access Token（带 gist 权限）和一个有效的 Gist ID。缺一不可，漏填或填错任意一个，Sync Settings: Backup 都会静默失败，连错误提示都不给。
- Token 必须勾选
gist权限，其他权限全不勾也能用；生成后只显示一次，务必立刻复制，关页就丢 - Gist ID 不是随便建个 gist 就行：要先用那个 Token 创建一个 secret gist（哪怕内容空着、文件名乱写），然后从 URL 末尾抠出那串字母数字组合，比如
https://gist.github.com/abc123def456中的abc123def456 - Token 和 Gist ID 都要粘贴进
sync-settings插件设置页的对应输入框，保存后才生效
备份和恢复命令必须手动触发，没有自动同步
sync-settings 默认不会监听你改了主题或装了新插件就自动上传，所有同步都是“快照式”的一次操作。这意味着你改完设置后，不主动执行 Sync Settings: Backup，新配置就永远留在本地，换电脑时恢复的还是上次备份的老状态。
- 备份命令：
Ctrl+Shift+P→ 输入Sync Settings: Backup→ 回车；成功后可在 GitHub Gist 页面看到更新时间 - 恢复命令：
Ctrl+Shift+P→Sync Settings: Restore→ 回车；它会覆盖当前所有设置、插件列表、快捷键等，不是“合并” - 想验证是否真同步成功？运行
Sync Settings: View Backup，会直接跳转到你的 gist 页面；或者用Sync Settings: Check Backup看最后一条日志
同步内容包含插件列表但不自动安装，恢复时需联网重拉
插件名和版本号确实会打进 gist，但 sync-settings 只管记录，不管安装。执行 Sync Settings: Restore 后，Atom 会读取 gist 里的 packages.json，然后调用 apm install 逐个下载——这时候如果网络卡、apm 源慢、或某个插件已下架，就会卡住或报错，而界面只显示“正在恢复”，没进度条也没明细错误。
- 常见卡顿现象：
linter、atom-beautify这类依赖多的插件容易拖慢整个恢复流程 - 如果某插件安装失败，
sync-settings不会中断，但后续依赖它的功能（比如语法检查）就直接失效 - 建议恢复前确保
apm可用：apm --version能输出版本号，且apm config get proxy没设错代理
Token 和 Gist ID 别存 Atom 设置里就不管了
很多人填完 token 和 gist ID 就以为万事大吉，结果半年后换电脑，发现旧 gist 被删了、token 过期了、或者 GitHub 改了权限策略（比如 2025 年起要求 token 增加 read:gist 显式权限），导致 restore 直接 404。这不是插件问题，是凭证生命周期管理被忽略了。
- Token 有有效期，GitHub 默认设为“no expiration”，但企业账号或安全策略可能强制设为 30 天；定期检查
Settings → Developer settings → Personal access tokens列表 - Gist ID 对应的 gist 不能手动删，也不能设成 public（
sync-settings强制用 secret gist）；删了就等于备份丢失 - 最稳妥做法：把 token 和 gist ID 存在密码管理器或加密笔记里，别只靠 Atom 插件界面记着
