Sync Settings: Backup没反应最常见原因是Personal Access Token和Gist ID缺一不可，只填其一将导致静默失败；token须勾选gist权限且仅显示一次，Gist ID必须为secret gist URL末尾的唯一字符串。
sync-settings 插件必须同时填对 Personal Access Token 和 Gist ID，缺一不可，否则备份/恢复会静默失败或报 404。
为什么 Sync Settings: Backup 没反应、也不报错？
最常见原因是凭证配置不全：只填了 token 没填 Gist ID，或反之。GitHub API 要求二者同时存在才能写入 secret gist；只填其一，命令执行时既无弹窗提示，也无终端日志，看起来就像“点了没反应”。
-
token必须勾选gist权限（其他权限全不勾也行），且生成后仅显示一次，关页即丢 -
Gist ID不是随便一个 gist 地址，必须是「secret gist」URL 末尾那串字符（如https://gist.github.com/7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d中的7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d） - 国内网络访问
gist.github.com不稳定，Backup 过程中请求超时会直接中断，Atom 界面无任何提示
Sync Settings: Restore 卡在“正在恢复”，插件没装上怎么办？
恢复不是“一键安装”，而是 Atom 读取 gist 里的 packages.json 后，调用 apm install 逐个拉取插件——这个过程完全依赖本地 apm 的可用性与网络质量。
- 先验证
apm --version是否能正常输出；若报错，说明 Atom 的包管理器未就绪 - 检查代理设置：
apm config get proxy，国内用户常因 proxy 配错或未设而卡死 - 大体积或依赖多的插件（如
linter、atom-beautify）容易拖慢整条链路，某个失败不会中断流程，但后续功能（如语法检查）直接失效 - 恢复期间不要关闭 Atom 或切出窗口，它不支持断点续传
哪些内容会被同步？哪些不会？
sync-settings 同步的是你“主动修改并保存过”的配置项，不是整个 ~/.atom 目录镜像。
- ✅ 同步：启用的插件列表（
packages.json）、UI 主题、核心编辑器设置（tab length、font size 等）、快捷键映射（keymap.cson） - ❌ 不同步：项目工作区布局（比如分屏状态）、未启用插件的配置文件、手动放进
~/.atom/packages/的私有源码、汉化包的翻译资源文件（simplified-chinese-menu的def/*.json） - ⚠️ 注意：
token和Gist ID本身不会被同步进 gist，它们只存于本地插件设置里，换机器时必须手动重填
真正容易被忽略的点是：恢复成功 ≠ 所有功能可用。即使 Sync Settings: Restore 显示完成，也要手动确认 apm list --installed --bare 输出的插件是否齐全，再打开开发者工具（Ctrl+Shift+I）看控制台有没有 Failed to require 类错误——很多问题其实卡在插件加载阶段，而不是同步环节。
