根本原因是Atom 1.60+移除旧Node.js模块兼容，导致atom-beautify依赖的js-beautify旧版因使用废弃Buffer()构造函数而静默崩溃；需升级至v0.33.4+并重装，配置On Save及语言专属规则，确保grammar正确且避免与linter-eslint冲突。
为什么 atom-beautify 装不上或不生效
根本原因不是插件本身坏了，而是 Atom 1.60+ 版本彻底移除了对旧版 Node.js 模块的兼容支持，而 atom-beautify 的某些依赖（比如 js-beautify 旧版）仍尝试用已被废弃的 Buffer() 构造函数初始化——这会导致插件加载失败，甚至让整个格式化菜单变灰。
- 装完插件后右键没“Beautify”选项？大概率是这个错误在后台静默崩溃了，打开开发者工具（
Ctrl+Shift+I）能看到TypeError: Buffer is not a function - 别急着换插件，先升级：在 Atom 设置里进
Install→ 搜索atom-beautify→ 确保安装的是 v0.33.4 或更高版本（它已切换到现代js-beautify@1.14+） - 如果已有旧版，必须手动卸载再重装，Atom 不会自动覆盖升级
配置 atom-beautify 让它真正“自动”格式化
默认它只响应右键菜单或快捷键，所谓“自动格式化”得靠触发时机 + 规则绑定。关键不是开个开关，而是告诉它：“什么文件、什么时候、按什么规则动”。
- 打开
Settings → Packages → atom-beautify → Settings - 勾选
On Save（保存时格式化），但注意：它不会格式化未保存的脏缓冲区，只作用于磁盘上已写入的文件 - 语言规则要单独配：点开
Language Specific Options，找到javascript或typescript，把indent_size改成 2，space_in_empty_paren设为true——这些参数名必须和js-beautify文档一致，拼错就无效 - 如果项目有
.jsbeautifyrc，插件会优先读它；但 Atom 的 UI 配置项会覆盖 rc 文件里的同名字段
用 prettier-atom 替代？小心 ESLint 冲突
很多人转投 prettier-atom 是因为 Prettier 更贴近现代工程实践，但它和 Atom 原生的 linter-eslint 插件共存时容易打架：一个在保存时格式化，一个在编辑时标红，结果代码光标乱跳、格式反复被改。
- 必须关掉
linter-eslint的Fix on save（在它的 Settings 里），否则两个插件抢着修同一行，prettier-atom的formatOnSave可能被覆盖 -
prettier-atom默认不处理.vue或.svelte文件，需要手动在设置里加 language ID：vue、svelte - 它的配置文件认
.prettierrc，但如果你项目里同时有prettier.config.js和.prettierrc，插件只读前者——这点和 CLI 行为不一致，容易误判
格式化失效的隐藏原因：语法解析器没对上
Atom 不是靠文件后缀判断语言，而是靠当前编辑器右下角显示的 grammar（比如 “JavaScript (Babel)”、“TypeScriptReact”）。如果 grammar 错了，atom-beautify 或 prettier-atom 根本不会启动。
- 检查右下角语言名，点击它 → 选 “Grammar Selector” → 手动设为正确 grammar（例如 React 文件选
source.js.jsx，不是source.js） - 某些模板文件（如
.ejs、.njk）默认无对应 beautifier，得去插件设置里手动映射：在atom-beautify的General Options → Languages里加一条ejs: html - 自定义 grammar（比如公司内部 DSL）必须提供
scopeName，且插件配置中 language key 必须和 scopeName 完全一致，大小写都不能错
Atom 的格式化不是“装了就灵”，它卡在 grammar 解析、Node 模块兼容、多插件职责边界这三个地方。调不通时，先看右下角语言名，再开开发者工具瞄一眼报错，最后确认配置项名有没有手抖——比重装插件快得多。
