sync-settings 插件已彻底失效，因GitHub Gist API自2022年底禁写且Atom 1.75+中断OAuth；实际仅同步config.cson等纯文本文件，推荐改用git手动管理配置。
sync-settings 插件在 2026 年已完全失效，填 GITHUB_TOKEN 和 GIST_ID 也同步不了——GitHub Gist API 自 2022 年底起拒绝所有写操作，返回 403 Forbidden；Atom 1.75+ 又彻底中断 OAuth 授权跳转流程。你看到的“备份成功”提示，大概率是插件前端的假反馈，背后根本没发出去请求。
为什么 sync-settings 点 Backup 没反应、也不报错
-
GITHUB_TOKEN和GIST_ID必须同时正确填写，缺一不可；只填一个，插件就静默失败，不提示、不报错 -
GITHUB_TOKEN必须勾选gist权限，且生成后仅显示一次，关页即丢，不存就永远找不回 -
GIST_ID必须来自 secret gist（不能是 public），且必须从 URL 末尾完整截取，例如<a href="https://www.php.cn/link/ab3af36d0bfd62e15276f46dbcb21592">https://www.php.cn/link/ab3af36d0bfd62e15276f46dbcb21592</a>中的abc123def456 - 国内直连
gist.github.com常超时，但 Atom 不暴露网络错误，只卡住或跳转空白页
实际能同步哪些文件？哪些根本不会动
sync-settings 名义上支持“设置、快捷键、样式、插件列表”，但真正上传到 gist 的只有以下纯文本文件：
-
config.cson：缩进、字体、自动保存等核心开关 -
keymap.cson：快捷键映射（改完需重启 Atom 才生效） -
snippets.cson和styles.less：代码片段与自定义样式 -
init.coffee：启动脚本（如有） -
packages.json：仅插件名列表，不含插件本身
以下内容完全不备份：
- 工作区布局（分屏状态、打开的标签页）
- 插件自身的配置（如
autocomplete-plus的词典路径） - 汉化包
simplified-chinese-menu的翻译资源 -
~/.atom/packages/下任何二进制或node_modules -
storage/、compile-cache/等临时目录
替代方案：用 git 手动管理核心配置文件
这才是目前唯一稳定、可审计、跨平台的同步路径：
- 进入
~/.atom目录（macOS/Linux）或%USERPROFILE%.atom（Windows） - 执行：
git init<br>git add config.cson keymap.cson snippets.cson styles.less init.coffee<br>git commit -m"initial config"
- 忽略非文本内容：
git ignore掉storage/、compile-cache/、packages/*/node_modules - 国内用户务必执行：
git config --global core.autocrlf input，避免行尾符冲突 - 恢复时先
git pull，再运行：apm list --installed --bare | xargs apm install - 若
apm install卡住，先切镜像：apm config set registry <a href="https://www.php.cn/link/1a53f094bf3e0b655e301f80d149d974">https://www.php.cn/link/1a53f094bf3e0b655e301f80d149d974</a>，并确保~/.atom/packages/是空目录
apm install 恢复插件时容易失败的关键点
-
apm --version必须能正常输出；若报错，需在 Atom 中按Cmd+Shift+P→ 输入Install Shell Commands补全 PATH -
apm config get proxy查看代理设置，国内用户常因未设或设错导致超时 - 编译型插件（如
term3、build）需提前装好python2（Linux/macOS）或Visual Studio Build Tools（Windows） - 某些插件的独立配置（如
autocomplete-plus的自定义词典）不在同步范围内，得单独导出~/.atom/autocomplete-plus/下的 JSON 文件
跨设备恢复时，config.cson 里硬编码的路径、字体名（如 "Fira Code"）可能不兼容目标系统，得手动检查替换。
