Atom Beautify 默认不启用，需确保语法识别正确、安装对应CLI工具（如js-beautify）、为每种语言单独开启beautify_on_save，且文件编码为UTF-8，五者缺一不可。
Atom 里按 Ctrl+Alt+B 没反应、保存不自动格式化、右键没“Beautify”选项——不是插件装错了，而是 atom-beautify 处于“静默待命”状态：它只在语言识别正确、底层 CLI 工具就位、且对应语言的开关打开时才执行美化。
Ctrl+Alt+B 快捷键无效？先看 grammar 和 CLI 工具
快捷键没反应，90% 是因为 Atom 根本没把当前文件当目标语言处理，或者背后缺执行器。
- 点编辑器右下角显示的
grammar名称（比如 “Plain text”），手动选成JavaScript、HTML、CSS等明确类型；Source或Null Grammar下 atom-beautify 直接跳过 - 对
.vue、.jsx、Dockerfile这类文件，需进Config → Core → File Types手动加映射，例如："Dockerfile": ["source.dockerfile"] - 报
beautifier not found？说明缺 CLI 工具：前端运行npm install -g js-beautify prettier，Python 项目装autopep8或black，C/C++ 必须下载uncrustify可执行文件并加入系统PATH - 装完 CLI 工具后，必须重启 Atom 全进程（不只是禁用再启用插件）
保存时自动格式化（beautify_on_save）为什么不起作用？
这个功能不是全局开关，而是按语言隔离的。漏勾一个语言，该类型文件保存时就完全不触发。
- 路径：
Packages → atom-beautify → Settings，向下滚动找到具体语言区块（如JavaScript、CSS、HTML） - 每个语言区块里都有独立的
beautify_on_save复选框，必须一个个手动勾上；开了 JS 却没开 HTML，.html 文件保存照样原样不动 - C/C++ 等语言默认无内置美化器，即使勾了
beautify_on_save，也得在对应语言设置里填入Config Path指向uncrustify可执行文件，否则静默失效
配置文件（.jsbeautifyrc / .prettierrc）和 UI 设置谁优先？
配置文件会覆盖 UI 设置，但仅限它明确声明的字段；未声明项仍回退到 UI 值。冲突常发生在团队协作中。
-
.jsbeautifyrc必须是合法 JSON，字段名严格区分大小写（indent_size有效，indentSize被忽略） - 若用了
prettier，建议项目根目录放.prettierrc；否则它用自身默认规则，容易和团队eslint风格打架 -
.editorconfig会被读取，但只影响缩进、换行等基础项，不接管括号风格或引号逻辑 - 文件编码不是 UTF-8（比如 GBK）时，atom-beautify 会静默失败——不报错、不格式化，这是最容易被忽略的硬性前提
真正卡住人的地方，往往不在“怎么装”，而在“它认不认你当前这行代码”。语法识别、CLI 可执行性、语言级开关、配置文件合法性、文件编码——五者缺一不可，且任一环节出问题都表现为“没反应”，而不是报错提示。
