config.cson 文件位于 ~/.atom/config.cson(macOS/Linux)或 %USERPROFILE%\.atom\config.cson(Windows),全局唯一,可通过 Cmd+Shift+P / Ctrl+Shift+P 输入“Application: Open Your Config”快速打开。

config.cson 文件在哪?直接定位路径
你的 config.cson 就在 ~/.atom/config.cson(macOS/Linux)或 %USERPROFILE%\.atom\config.cson(Windows),不是项目里,也不是插件目录下——它只有一份,全局生效。
别费劲找“Atom安装目录下的config”,那是错的;也别用资源管理器盲目搜索,容易点进缓存或旧备份。最稳的方式是:按 Cmd+Shift+P(macOS)或 Ctrl+Shift+P(Windows/Linux),输入 Application: Open Your Config 回车,Atom 自动打开正确文件。
- 首次打开可能是空文件,别慌,它合法 —— CSON 允许空对象
- 如果 Atom 正在运行时你手动改了这个文件,**不用重启**,大部分配置(如
disabledPackages、core.encoding)会热加载生效 - 改完保存后,万一 Atom 报错打不开,就删掉刚加的几行,CSON 对缩进和逗号极其敏感,多一个空格或少一个冒号都会让整个配置失效
怎么写才不报错?CSON 语法避坑要点
CSON 不是 JSON,也不是纯 YAML —— 它是 CoffeeScript 的对象字面量语法,靠**缩进**和**冒号+空格**定义结构,没有花括号,也不需要引号包住键名(除非含特殊字符)。
比如你想禁用 welcome 和 exception-reporting 插件,这样写就对:
core:
disabledPackages: [
"welcome"
"exception-reporting"
]-
disabledPackages必须是数组,每项用双引号包裹字符串,末尾不能有逗号 -
core:后必须换行+缩进(2 或 4 空格均可,但全文要一致),不能写成core: disabledPackages: [...] - 别把
customFileTypes写成customfiletypes(大小写敏感);也别漏掉最外层的"*":—— 虽然部分配置省略它也能工作,但官方推荐加上,避免插件覆盖时行为异常 - 想加注释?用
#开头,且必须独占一行或放在行尾,不能跟在值后面还带空格("welcome" # 注释✅,"welcome"#注释❌)
改完没反应?常见配置不生效原因
写了 customFileTypes 却还是无法高亮 .wxml?禁用了插件但图标还在侧边栏?大概率是这几个地方卡住了:
- Atom 没读到你改的配置:检查文件是否保存成功(编辑器标题栏有没有 * 号),以及是否误存为
config.cson.bak或config.json - 语法高亮没触发:关掉所有
.wxml标签页,再重新打开一个,或者按Ctrl+Shift+L手动选中Text HTML Basic语法 - 插件被其他配置绕过:有些插件(比如
platformio-ide)会在自己的设置里强行启用某些服务,此时仅在disabledPackages里写名字不够,得去插件设置页单独关掉子功能 - 权限问题(尤其 macOS):如果你用
sudo atom启过编辑器,~/.atom所有权可能变成 root,导致普通用户无法写入配置 —— 运行ls -la ~/.atom看 owner 是不是你本人
哪些配置值得优先手动加?实用高频项
比起点开 Settings 页面一页页翻,直接写 config.cson 更快、更可复现。以下几项建议手敲,它们影响大、GUI 不好调:
- 默认编码强制 UTF-8:
core: encoding: "utf8"(避免中文乱码,尤其跨平台协作时) - 微信小程序支持:
core: customFileTypes: { 'text.html.basic': ['wxml'], 'source.css': ['wxss'], 'source.js': ['wxs'] } - 隐藏 Git 忽略文件:
"tree-view": hideVcsIgnoredFiles: true(比每次右键「Hide VCS Ignored Files」强) - 关闭启动欢迎页:
welcome: showOnStartup: false(省掉每次多点一下 ×)
复杂点在于嵌套层级和拼写容错率低 —— 写完 Ctrl+S 后,顺手按 Cmd+, 进 Settings 看一眼「Core」页里对应项是否已同步变灰,比猜强。

















