sync-settings 插件在2026年已完全不可用，因其依赖的GitHub Gist API与Atom OAuth于2022–2024年间分阶段失效，且仅支持手动备份、不监听文件变化；常见失败原因为GITHUB_TOKEN与GIST_ID缺失或不匹配、权限未勾选gist、GIST_ID格式错误（需纯ID非URL）、国内网络超时无提示；它仅同步config.cson等6类纯文本配置，不涉及插件源码、汉化包、UI布局及缓存目录；可靠替代方案是用git手动管理~/.atom目录，并配合apm批量重装插件。
sync-settings 插件在 2026 年已完全不可用，所谓“实时备份”根本不存在——它从不监听文件变化，只支持手动触发 sync-settings:backup，且整条同步链路（GitHub Gist API + Atom OAuth）已在 2022 年底至 2024 年间分阶段失效。
sync-settings:backup 为什么点下去没反应、也不报错？
最常见的情况是凭证缺失或错误：
- 只填了
GITHUB_TOKEN没填GIST_ID，或反之；GitHub API 要求二者同时存在且匹配，缺一就静默失败 -
GITHUB_TOKEN未勾选gist权限（其他权限全不勾也行），生成后页面关闭即丢失，无法重看 -
GIST_ID填的是完整 URL（如https://gist.github.com/abc123def456），实际只需末尾那串字符abc123def456，且必须对应 secret gist（public gist 不被接受） - 国内直连
gist.github.com极不稳定，超时后 Atom 界面无任何提示，看起来就像卡住
它到底同步哪些文件？哪些你根本指望不上
sync-settings 只上传你主动修改并保存过的纯文本配置，不是镜像整个 ~/.atom 目录：
- ✅ 会同步：
config.cson、keymap.cson、snippets.cson、styles.less、init.coffee、packages.json（仅插件名列表） - ❌ 完全不碰：
~/.atom/packages/下的插件源码、汉化包（def/*.json）、插件独立配置（如autocomplete-plus的词典）、工作区布局、storage/和compile-cache/等二进制/缓存目录
替代方案：用 git 手动管理才是唯一可靠路径
别再折腾 token 和 gist，直接在 ~/.atom 下初始化 git：
- 执行：
git init && git add config.cson keymap.cson snippets.cson styles.less init.coffee - 创建
.gitignore，明确排除：storage/、compile-cache/、packages/*/node_modules、packages/*/build/ - 跨平台务必设：
git config --global core.autocrlf input，否则 Windows/Mac/Linux 行尾符冲突会导致配置解析失败 - 恢复插件用：
apm list --installed --bare | xargs apm install（国内建议先配镜像：apm config set registry https://npmmirror.com/mirrors/atom）
真正麻烦的从来不是备份动作本身，而是误以为 sync-settings 能覆盖所有配置——它连插件本体都不传，更别说汉化资源和 UI 布局。手动 git 看似多一步，但每行 git commit -m "update keymap" 都比等一个永远不出现的绿色提示靠谱。
