sync-settings 插件在2026年已完全失效，因其依赖的GitHub Gist写接口自2022年底起返回403，且Atom 1.75+彻底中断OAuth流程，插件自2021年起无人维护。
sync-settings 插件在 2026 年已完全失效，填 token、点 backup、等进度条——全是白忙活。 它依赖的 GitHub Gist API 自 2022 年底起拒绝写操作（返回 403 Forbidden），Atom 1.75+ 版本又彻底中断了 OAuth 流程。你看到的“静默卡住”“Failed to fetch gist list”或打开 sync-settings:view-backup 跳到 404 页面，不是配置错，是整条链路已物理性断开。
为什么 sync-settings 现在根本不能用
它不是“不稳定”，而是底层服务被废弃：
- GitHub 关闭了 Gist 的写接口，所有
POST /gists请求都返回403，backup 命令注定失败 - Atom 升级到 1.75+ 后，Electron 内核不再支持旧版 OAuth 重定向流程，
Authorize with GitHub按钮点下去没反应，或跳转后空白 - 即使你手动生成了带
gist权限的 Personal Access Token，插件也读不到——它调用的是已下线的 API v3 endpoint - 插件本身未更新，最后一次有效 commit 停留在 2021 年，没人维护
真正能跨设备同步 Atom 配置的只有 git 手动管理
Atom 所有用户级配置都在 ~/.atom/ 目录下，其中只需同步几个纯文本文件：
-
config.cson（核心设置，含插件开关、主题、字体等） -
keymap.cson（快捷键映射，改完不重启 Atom 就不会生效） -
snippets.cson（代码片段） -
styles.less（自定义样式） -
init.coffee（启动脚本） -
packages/下启用插件的元数据（用apm list --installed --bare输出验证）
实操建议：
- 新建一个私有 git 仓库，只
git add上述文件，.gitignore里明确排除storage/、compile-cache/、packages/*/node_modules - 跨平台（Windows/macOS/Linux）时，设
git config --global core.autocrlf input防止行尾符冲突 - 国内恢复插件前，先换源：
apm config set registry https://npmmirror.com/mirrors/atom - 每次改完
keymap.cson或装新插件后，手动git add+git commit -m "update keymap"，别信“自动同步”
如果你非要用 sync-settings（比如内网离线环境）
必须同时满足三个硬条件，缺一不可：
- Personal Access Token 必须勾选
gist权限，且生成后立刻存入密码管理器——页面关闭就再也看不到 - Gist ID 必须来自 secret gist，URL 形如
https://gist.github.com/abc123def456，末尾的abc123def456是唯一合法 ID；public gist 或随便建的 gist 都不行 - 执行
sync-settings:backup前，确保 Atom 已完整重启——否则keymap.cson变更不会被读取，新机器上快捷键直接失效
注意：sync-settings 只存插件名，不打包插件本身；sync-settings:restore 时靠 apm install 实时拉取，一旦某个插件下架（如 linter-jshint），恢复就会失败。
最常被忽略的一点：sync-settings 从不处理 ~/.atom/packages/ 下插件的本地修改（比如自己 patch 过的 fork），这些改动不会进 gist，也不会被 restore —— 它只管“装什么”，不管“怎么改”。真要保这些，还是得 git 管理整个 packages/ 目录（慎用，体积大）。
