sync-settings插件在2026年已完全失效，因其依赖的github gist api自2022年底起拒绝写操作且atom 1.75+中断oauth流程；它仅同步config.cson等少数文本文件，不包括工作区布局、插件本身或汉化资源；可靠方案是用git手动管理核心配置文件。
sync-settings 是 Atom 实现云端自动同步的唯一可靠方式，它不依赖 Microsoft 账户或 VSCode 同步机制，而是把配置存到 GitHub Gist。如果你刚换电脑、重装系统，或想在多台设备间保持一致的编辑体验，必须用它——手动复制 ~/.atom/config.cson 或插件列表容易漏项、权限出错、路径不兼容。
为什么不能直接复制 config.cson？
Atom 的配置不是纯文本文件那么简单：config.cson 里可能包含绝对路径（比如自定义 snippets 路径）、平台相关键位绑定（cmd vs ctrl）、未启用插件的残留配置；packages 目录下还有二进制编译产物（如 language-rust 的 native module），直接拷贝会触发重编译失败或报 Cannot find module './build/Release/tree_sitter_rust_binding'。而 sync-settings 只上传声明式配置（启用哪些包、keymap 怎么设），还原时走标准 apm install 流程，天然规避这些问题。
token 和 gist id 必须配对且稳定
GitHub token 决定你有没有写权限，gist id 决定写到哪个“容器”。这两者必须同时正确才能 restore 成功：
- token 只需勾选
gist权限，生成后务必保存——GitHub 不再显示第二次 - gist id 是 URL 里
https://gist.github.com/username/abc123def456中的abc123def456，不是整个 URL - 新电脑 restore 前，必须填和旧电脑**完全一致**的 gist id；填错会导致创建空 gist，restore 时提示
No settings found in gist - token 可以不同，但 gist id 绝对不能变——哪怕你换了 GitHub 账号，也得用原账号导出旧 gist 内容，再导入新账号
备份和还原操作必须用命令面板触发
不要试图在终端跑 apm sync 或改 sync-settings 配置项——这个插件没提供 CLI 接口。所有动作都得通过 Atom 内置命令面板执行：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）呼出命令面板 - 输入
sync settings: backup执行上传，成功后状态栏右下角会弹出 “Settings backed up to gist” - 输入
sync settings: restore执行拉取，过程中会自动安装缺失插件（如file-icons），但不会覆盖已禁用的插件 - 如果 restore 卡住不动，检查 Atom 是否有未关闭的弹窗（比如插件安装失败提示），关掉再试一次
真正容易被忽略的是：每次 backup 都会全量覆盖 gist 内容，不会做 diff 或版本保留。你删掉一个插件后 backup，旧插件配置就永久丢失了。需要回滚？只能去 GitHub 上手动翻 gist 的历史版本（点 gist 页面右上角 “Revision history”），复制旧内容粘贴回来——没有一键回退。
