sync-settings 插件在2026年已完全失效，因其依赖的GitHub Gist API自2022年底起拒绝写操作且Atom 1.75+中断OAuth流程；它仅同步config.cson、keymap.cson等少数文本文件，不包括工作区布局、插件本身或汉化资源；可靠方案是用git手动管理核心配置文件。
sync-settings 插件在 2026 年已完全失效，填 token 和 gist ID 也白搭。 它依赖的 GitHub Gist API 自 2022 年底起拒绝所有写操作，返回 403 Forbidden；Atom 1.75+ 版本又彻底中断了 OAuth 流程。你现在点 Sync Settings: Backup，大概率静默卡住，或报 Failed to fetch gist list——不是你网络差，是整条链路已断。
为什么 Sync Settings: Backup 没反应、也不报错？
最常见的原因是凭证配置不全：只填了 GITHUB_TOKEN 没填 GIST_ID，或反之。GitHub API 要求二者同时存在才能写入 secret gist；缺一不可，命令就直接静默失败，连错误提示都不给。
-
GITHUB_TOKEN必须勾选gist权限（其他权限全不勾也行），且生成后仅显示一次，关页即丢 -
GIST_ID不是随便一个 gist 地址，必须是https://gist.github.com/abc123def456中末尾那串字符，且对应的是 secret gist（不是 public） - 国内访问
gist.github.com不稳定，请求超时会中断，Atom 界面无任何提示
哪些内容会被 sync-settings 同步？哪些根本不会？
它同步的只是「你主动改过并保存过的文本配置」，不是整个 ~/.atom 目录镜像。真正落地写进 gist 的只有几个纯文本文件：
-
config.cson（核心设置，如 tab length、font size） -
keymap.cson（快捷键映射） -
snippets.cson（代码片段） -
styles.less（自定义样式） -
init.coffee（初始化脚本） -
packages.json（插件名列表，不含插件本身）
以下内容 不会同步：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 项目工作区布局（分屏、打开的文件标签页）
- 未启用插件的配置文件
- 手动放进
~/.atom/packages/的私有插件源码 - 汉化包
simplified-chinese-menu的翻译资源文件（def/*.json） - 某些插件的独立配置（如
autocomplete-plus的自定义词典）
真正能跨设备同步 Atom 配置的只有 git 手动管理
新建一个私有 git 仓库，只跟踪上述核心文本文件，忽略所有二进制和临时内容：
- 在
~/.atom目录下执行：git init && git add config.cson keymap.cson snippets.cson styles.less init.coffee - 忽略
storage/、compile-cache/、packages/*/node_modules等目录 - 跨平台时设
git config --global core.autocrlf input，避免行尾符冲突 - 恢复插件用：
apm list --installed --bare | xargs apm install（国内先配镜像：apm config set registry https://npmmirror.com/mirrors/atom）
每次改完快捷键或主题后，手动 git add + git commit —— 别指望“自动同步”这种幻觉。
最容易被忽略的一点是：即使 Sync Settings: Restore 显示完成，也要手动运行 apm list --installed --bare 确认插件是否齐全，再打开开发者工具（Ctrl+Shift+I）看控制台有没有 Failed to require 报错。恢复成功 ≠ 功能可用。
