config.cson文件位于~/.atom/config.cson(macos/linux)或%userprofile%.atom\config.cson(windows),最稳打开方式是cmd+shift+p或ctrl+shift+p输入“application: open your config”;改完保存后无需重启,大部分配置热加载生效,但customfiletypes需关闭对应标签页再重开,语法错误会导致整个文件失效。

config.cson 文件在哪,改完要不要重启
直接按 Cmd+Shift+P(macOS)或 Ctrl+Shift+P(Windows/Linux),输入 Application: Open Your Config 回车——这是唯一稳的路径,别手动翻 %USERPROFILE%\.atom\config.cson 或 ~/.atom/config.cson,容易点错缓存或旧备份。
改完保存,不用重启 Atom,大部分配置(比如 disabledPackages、core.encoding)会热加载生效。但以下情况例外:
-
customFileTypes修改后需关掉所有对应后缀的标签页再重开,否则高亮不触发 - 如果 Atom 报错打不开,大概率是刚加的几行语法错了,删掉重试
- 文件没保存成功(标题栏没带
*)也会导致“改了等于没改”
写 config.cson 最容易踩的语法坑
CSON 不是 JSON,也不是 YAML,它是 CoffeeScript 对象字面量,靠缩进和冒号+空格定义结构。写错一个空格或少个换行就整个文件失效。
-
core:后必须换行 + 缩进(2 或 4 空格均可,但全文保持一致),不能写成core: disabledPackages: [] -
disabledPackages必须是数组,每项用双引号包裹:"welcome",末尾不能有逗号 - 键名大小写敏感:
customFileTypes写成customfiletypes就不生效 - 注释必须独占一行或放在行尾:
"welcome" # 注释✅,"welcome"#注释❌
哪些配置值得优先加进 config.cson
日常高频修改的配置建议集中写在 core 和 editor 区块下,避免散落难维护:
-
core:下加disabledPackages: ["welcome", "exception-reporting"]关掉干扰插件 -
editor:下设fontFamily: 'Fira Code', fontSize: 14, lineHeight: 1.4—— 注意:这仅影响编辑区,侧边栏/状态栏字体要另改styles.less - 需要连字(ligatures)?除了
fontFamily,还得在styles.less里显式声明font-variant-ligatures: common-ligatures; - 想让
.wxml高亮?加customFileTypes: {"text.html.basic": ["wxml"]},然后手动选一次语法(Ctrl+Shift+L)
keymap.cson 改快捷键为什么没反应
快捷键绑定必须写在 ~/.atom/keymap.cson,且改完要执行 Window: Reload(Ctrl+Alt+R)或重启 Atom,热加载不生效。
- 作用域(scope)决定快捷键是否触发:在编辑器里绑的
ctrl-s,在命令面板(Cmd+Shift+P)里默认不响应,因为那是.platform-darwin .command-palettescope - 覆盖默认行为要分两步:先
'*': 'ctrl-s': 'unset!',再按需绑定,比如'.source.js': 'ctrl-s': 'prettier:format' - 命令名必须准确:
prettier:format来自prettier-atom插件,js-beautify:beautify-editor来自js-beautify,拼错就静默失败 - 某些插件(如 prettier-atom)需额外开启“格式化时自动保存”,否则
prettier:format可能无输出
CSON 对格式极其敏感,缩进、冒号、引号、换行缺一不可;真正麻烦的不是写什么,而是写对——建议每次只改一行,保存后立刻验证效果。











