Atom用户配置无内置导出功能,真实有效备份需手动复制config.cson和keymap.cson文件,路径依系统而异:Windows为%USERPROFILE%\.atom\,macOS/Linux为$HOME/.atom/;还需用apm命令导出并重装插件及主题列表。

Atom 的用户配置不能靠“导出”按钮完成,它没有内置导出功能;真实有效的备份,就是直接复制 config.cson 和 keymap.cson 这两个文件。
Atom 的配置文件在哪?路径因系统而异
Atom 不像 VSCode 那样把所有设置塞进一个 settings.json,它的核心配置分散在几个 CSON 文件里,其中最关键的两个是:
-
config.cson:存所有 UI、编辑器、包开关、自动保存、缩进等全局设置 -
keymap.cson:存你自定义的快捷键映射(比如把ctrl-shift-p改成触发别的命令)
它们的位置取决于操作系统:
- Windows:
%USERPROFILE%\.atom\config.cson和%USERPROFILE%\.atom\keymap.cson - macOS:
$HOME/.atom/config.cson和$HOME/.atom/keymap.cson - Linux:
$HOME/.atom/config.cson和$HOME/.atom/keymap.cson
只备份 config.cson 不够,扩展和 UI 主题也得一起搬
config.cson 里虽然记录了哪些包已启用(如 "autocomplete-plus"),但它不保存扩展本身。没装扩展,配置就只是死文本。
导出已安装扩展列表最可靠的方式是命令行:
- macOS/Linux:
apm list --installed --bare > atom-extensions.txt - Windows PowerShell:
apm list --installed --bare | Out-File atom-extensions.txt
重装时用这个列表一键恢复:
- macOS/Linux:
cat atom-extensions.txt | xargs -I {} apm install {} - Windows PowerShell:
Get-Content atom-extensions.txt | ForEach-Object { apm install $_ }
注意:apm 命令必须可用。如果报 “command not found”,先在 Atom 里按 Cmd+Shift+P → 输入 Install Shell Commands 回车,它会把 apm 加进 PATH。
别忽略 UI 主题和语法主题的路径差异
Atom 的主题不是写在 config.cson 里的路径字符串,而是通过名字引用的,例如:
"core": {
"themes": ["one-dark-ui", "one-dark-syntax"]
}
这意味着:光有配置文件,没对应主题包,Atom 启动时会 fallback 到默认主题,甚至报错。
所以备份时还得确认这些主题是否已安装:
- 运行
apm list --themes --installed --bare查看已装主题名 - 主题包本身存在
$HOME/.atom/packages/下,名字带-ui或-syntax后缀(如one-dark-ui) - 如果用了自己写的主题,记得连整个主题目录一起备份(
$HOME/.atom/packages/your-theme-name)
直接替换 config.cson 可能导致解析失败
CSON 是 CoffeeScript 的子集,比 JSON 更宽松,但对缩进、括号、引号仍敏感。从别人那拷来的 config.cson 如果混用了空格/Tab、漏了逗号、或用了 Atom 新版本已弃用的字段(如旧版的 "editor.showInvisibles" 已被 "editor.renderWhitespace" 替代),Atom 启动时会静默失败,界面卡在加载状态,连开发者工具都打不开。
安全做法是:
- 用 Atom 自带的 Settings 视图(
Cmd+,)逐项核对关键项,而不是全量覆盖 - 重点关注语言专属块,比如
"*": {...}、"source.js": {...}、"source.python": {...}—— 这些容易因插件更新格式变动 - 改完
config.cson后,重启 Atom 并观察右下角是否有黄色警告图标,点开就能看到具体哪一行解析出错
真正麻烦的从来不是“怎么备份”,而是“怎么让备份在另一台机器上不崩”。CSON 的隐式语法、主题依赖、扩展版本兼容性,三者叠加后,手动 diff 比一键导入更可靠。

















