config.cson是atom唯一有效的全局配置文件,位于~/.atom/config.cson(macos/linux)或%userprofile%.atom\config.cson(windows),应通过cmd+shift+p/ctrl+shift+p执行“application: open your config”安全打开并热加载。

config.cson 就是 Atom 唯一有效的全局配置文件,改它就对了;其他地方写的设置基本不生效。
怎么安全打开 config.cson?别瞎找路径
它不在 Atom 安装目录里,也不在项目根目录下,更不是 config.json 或 settings.json。唯一正确位置是:
- macOS / Linux:
~/.atom/config.cson - Windows:
%USERPROFILE%\.atom\config.cson
但手动导航容易点错(比如进到缓存或旧备份)。最稳方式是:按 Cmd+Shift+P(macOS)或 Ctrl+Shift+P(Windows/Linux),输入 Application: Open Your Config 回车 —— Atom 自动打开真实文件,且支持热加载。
首次打开可能是空文件,合法;保存后不用重启,大部分配置(如 core.disabledPackages、core.encoding)会立即生效。
写 config.cson 为什么总报错?CSON 语法太脆
CSON 不是 JSON,也不是 YAML,它是 CoffeeScript 对象字面量语法:靠缩进和 : + 空格定义结构,没花括号,键名一般不加引号(除非含特殊字符)。
常见翻车点:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
core: disabledPackages: ["welcome"]❌ ——core:后必须换行 + 缩进(2 或 4 空格统一),不能挤在一行 -
"welcome",❌ —— 数组末尾不能有逗号 -
source.c: ["pc"]❌ —— 左侧 scope 必须加双引号:"source.c": ["pc"]✅ -
"welcome"# 注释❌ —— 注释前必须有空格:"welcome" # 注释✅,且不能跟在值后面还带多余空格
一旦保存后 Atom 打不开,大概率是刚加的几行语法错了,删掉重试最快。
哪些配置必须写进 config.cson?图形界面管不了
Settings 界面能调的只是冰山一角,以下行为只能靠 config.cson 显式声明:
- 新文件默认语言:
core.fileTypes,例如'.py': 'source.python'(装了language-python插件 ≠ 自动生效) - 非标准后缀高亮:
core.customFileTypes,例如"source.redis": ["redis.conf"](写成text.plain就没折叠、没高亮) - 单击树形视图即打开文件:
tree-view.openFilesWithOneClick: true(不是tree-view.focusOnReveal) - 字体与字号:
editor.fontFamily和editor.fontSize,图形界面设置容易被插件覆盖
注意:core.restorePreviousWindowsOnStart: true 只恢复窗口和路径,不恢复未保存内容 —— 那得靠 autosave 插件配合 core.continueSaveDialogOnExit: true。
改完没反应?先盯住这三个地方
配置写了却无效,大概率卡在这三处:
- 文件没真正保存成功:编辑器标题栏有没有
*号?是否误存为config.cson.bak或config.json? - 语法高亮/功能没触发:关掉所有目标类型文件(如
.wxml或.redis.conf),再重新打开一个;或按Ctrl+Shift+L手动选中对应语法模式 - 插件冲突导致 Settings 渲染失败:终端运行
atom --safe,如果此时能打开 Settings,说明某个已安装插件(如sync-settings或老旧主题)干扰了 UI 加载
CSON 对缩进和标点极其敏感,多一个空格、少一个冒号、错一层缩进,整个配置就失效 —— 这不是 Bug,是它的设计逻辑。别指望 Atom 给你报具体哪行错,它只会静默忽略或直接打不开。










