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

config.cson 是 Atom 唯一全局生效的配置入口，改它就对了；其他地方（比如插件设置页、styles.less、项目根目录）写的配置基本不接管核心行为。

config.cson 文件在哪？怎么安全打开？

别去 Atom 安装目录翻，也别用资源管理器全盘搜索 —— 那些路径全是错的。它只有一份，位置固定：

• macOS / Linux：~/.atom/config.cson
• Windows：%USERPROFILE%\.atom\config.cson

最稳方式：按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux），输入 Application: Open Your Config 回车，Atom 自动定位并打开正确文件。

首次打开可能是空文件，合法 —— CSON 允许空对象。改完保存后，**不用重启 Atom**，大部分配置（如 core.disabledPackages、core.encoding）会热加载生效。

写 config.cson 为什么总报错？CSON 语法避坑要点

CSON 不是 JSON，也不是 YAML，它是 CoffeeScript 对象字面量语法：靠缩进和 : + 空格定义结构，没有花括号，键名一般不用引号（除非含特殊字符）。

常见错误：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• core: disabledPackages: ["welcome"] ❌ —— 缺少换行和缩进，core: 后必须换行并缩进（2 或 4 空格统一即可）
• "welcome", ❌ —— 数组末尾不能有逗号
• "source.c": ["pc"] ✅，但写成 source.c: ["pc"] ❌ —— 左侧 scope 必须加双引号
• "welcome" # 注释 ✅，但 "welcome"#注释 ❌ —— 注释前必须有空格，且不能跟在值同一行还紧贴

一旦保存后 Atom 打不开，大概率是刚加的几行语法错了，删掉重试最快。

哪些配置必须写进 config.cson？绕不开的几个关键项

有些行为 Atom 绝不“猜”，也不让插件代劳，只能靠 config.cson 显式声明：

• 新文件默认语言：用 core.fileTypes，例如 '.py': 'source.python'，不是装了 language-python 插件就自动生效
• 非标准后缀高亮：用 core.customFileTypes，例如 "source.shell": ["log", "pc"]，别写成 "text.plain": ["log"]（没折叠、没缩进）
• 单击树形视图即打开文件：设 tree-view.openFilesWithOneClick: true，不是 tree-view.focusOnReveal
• 字体链与字号：在 editor: 下写 fontFamily 和 fontSize，图形界面设置容易被插件覆盖

注意：core.restorePreviousWindowsOnStart: true 只恢复窗口和路径，不恢复未保存内容 —— 那得靠 autosave 插件和 core.continueSaveDialogOnExit: true 配合。

改完没反应？检查这三件事

配置写了却无效，90% 出在这几个环节：

• 文件没真正保存：编辑器标题栏没出现 *，或误存为 config.cson.bak、config.json
• 语法高亮没触发：关掉所有对应后缀的标签页，再新开一个；或者手动按 Ctrl+Shift+L 调出 grammar selector 选一次
• 插件强行覆盖：比如 platformio-ide 会在自己设置页启用某些服务，此时仅在 disabledPackages 里写名字不够，得进插件设置页关子功能

CSON 对缩进、冒号、引号、空格极度敏感，多一个空格或少一个换行都可能让整个配置静默失效 —— 这不是 bug，是它的设计前提。