sync-settings插件在2026年已完全失效，因github gist api自2022年底起拒绝写操作并返回403错误，且atom 1.75+升级导致oauth流程中断；唯一可靠方案是手动git管理~/.atom下的config.cson、keymap.cson、snippets.cson、styles.less和init.coffee等核心文本文件，并配合apm install恢复插件。
sync-settings 插件在 2026 年已完全失效，填 token 和 gist ID 也同步不了——GitHub Gist API 自 2022 年底起拒绝所有写操作，返回 403 Forbidden；Atom 1.75+ 又彻底中断了 OAuth 流程。你看到的“备份成功”提示，大概率是插件前端的假反馈，背后根本没发出去请求。
sync-settings 插件为什么总卡住或静默失败
它不是坏了，是整条链路断了：GitHub 不收、Atom 不认、插件不报错。常见现象包括：Sync Settings: Backup 点击后无响应；Sync Settings: View Backup 打开 404 页面；Settings 页面填完凭证却没保存按钮反馈。
- Personal Access Token 必须勾选
gist权限，且生成后只显示一次——关页即丢，不存就永远找不回 - Gist ID 必须来自
secret gist（不能是 public），且必须从 URL 末尾完整截取，例如https://gist.github.com/abc123def456中的abc123def456 - 即使凭证全对，Atom 1.75+ 也无法完成 OAuth 授权跳转，终端里看不到
Failed to fetch gist list这类错误，而是直接静默中断
真正能跨设备同步 Atom 配置的只有 git 手动管理
Atom 所有用户级配置都落在 ~/.atom/（macOS/Linux）或 %USERPROFILE%\.atom\（Windows）下。你需要同步的只是几个纯文本文件，不是整个目录：
-
config.cson：核心设置（缩进、字体、自动保存等） -
keymap.cson：快捷键映射（改完必须重启 Atom 才生效） -
snippets.cson和styles.less：代码片段与自定义样式 -
init.coffee：启动脚本（若存在） - 插件列表靠
apm list --installed --bare导出，不存二进制包本身
实操建议：git init 新建私有仓库，只 git add 上述文件；忽略 storage/、compile-cache/、packages/*/node_modules；国内用户设 git config --global core.autocrlf input 防 CRLF/LF 混乱。
恢复插件时 apm install 卡住或失败怎么办
sync-settings 只记录插件名，不打包安装包。执行 Sync Settings: Restore 后，它调用的是本地 apm install 命令实时拉取——这一步失败，整个恢复就算“半残”。
- 先验证
apm --version是否可执行；若报错，需在 Atom 中按Cmd+Shift+P→ 输入Install Shell Commands补全 PATH - 检查代理：
apm config get proxy，国内用户常因未设或设错导致超时卡死 - 大体积插件（如
linter、atom-beautify）容易拖慢流程；某个插件安装失败不会中断后续，但依赖它的功能（比如语法检查）直接不可用 - 恢复期间不要切出 Atom 窗口——它不支持断点续传，中断后得重来
哪些内容看似被同步，其实根本没生效
sync-settings 的“同步”范围很窄，很多你以为会动的东西，它压根不管：
- 项目工作区布局（分屏、打开的标签页顺序）——完全不记录
- 汉化包
simplified-chinese-menu的翻译资源（def/*.json）——菜单开关状态会同步，但离线时资源缺失就回退英文 - 插件自身的配置文件（如
autocomplete-plus的自定义词典路径）——只记插件启用状态，不记内部设置 -
init.coffee或styles.less在 Atom 升级后可能因 API 变更而报错，插件不会预警也不会降级处理
最易被忽略的一点：token 和 gist ID 本身不会上传到 GitHub，换新机器时必须手动重填——它们只存在本地插件设置里，不属于任何同步快照。
