Atom Beautify 插件装完不工作？三步缺一不可
安装完 atom-beautify 插件后，别以为装上就能直接使用。它默认处于不工作状态，必须手动配置三个关键点：正确设置 grammar、安装对应的 CLI 工具并加入系统 PATH 环境变量、在语言设置中开启 beautify_on_save 开关。这三项，一个都不能少。
装完插件 ≠ 立即生效。它默认不执行格式化，必须手动配置 grammar、安装 CLI 工具、开启语言级开关，三者缺一不可。
为什么 Ctrl+Alt+B 没反应？先看右下角 grammar
Atom 判断文件的语言类型，不是靠文件后缀，而是看编辑器右下角显示的 grammar——比如“Plain text”或“Source”。只要显示的不是明确的语言类型，例如 JavaScript、HTML、CSS，那么 atom-beautify 就会直接跳过，快捷键和右键菜单全部失效。
- 点击右下角 grammar 名称，手动选择对应语言；对于无后缀文件，比如
Dockerfile、.env，需要进入Config → Core → File Types添加映射，例如："Dockerfile": ["source.dockerfile"] .vue、.jsx这类非标准后缀，默认不启用支持，必须去Packages → atom-beautify → Settings → Languages手动勾选- 如果 grammar 显示
Null Grammar，说明 Atom 完全未识别该文件，连语法高亮都没有，atom-beautify必然静默失效
报“beautifier not found”？你缺的是 CLI 工具，不是插件
atom-beautify 本身不直接格式化代码，它只是一个调度器：JS 调用 js-beautify 或 prettier，Python 调用 autopep8 或 black，C/C++ 必须使用 uncrustify。出现这个报错，说明命令行中根本找不到对应的可执行程序。
- 前端项目：运行
npm install -g js-beautify prettier，确保终端能直接执行js-beautify --version - Python 项目：安装
pip install --user autopep8 black，注意加上--user避免权限问题 - C/C++/Java：去 SourceForge 下载
uncrustify可执行文件（Windows 上为uncrustify.exe），解压后把所在目录加入系统PATH - 装完 CLI 工具后，必须重启 Atom 整个进程——关闭所有窗口再重新打开，仅禁用/启用插件无效
保存时自动格式化（beautify_on_save）怎么开？按语言单独设
这个功能并非全局开关，而是每个语言独立控制。开启了 JavaScript 的 beautify_on_save，但未开启 HTML，那么 .html 文件保存时依然不会格式化。
- 路径：
Packages → atom-beautify → Settings，往下滚动找到具体语言区块（比如JavaScript、CSS、HTML） - 每个语言区块里都有独立的
beautify_on_save复选框，必须逐个手动勾选 - C/C++ 等语言即使勾选了
beautify_on_save，也需在对应语言设置里填写Config Path，指向uncrustify可执行文件路径，否则仍然静默失效 - 文件编码必须为
UTF-8，否则可能触发乱码或中断
格式化结果和预期不符？引擎切换和规则冲突是主因
JS 默认使用 js-beautify，但如果你全局安装了 prettier 并勾选了 Use Prettier when available，它就会自动切换过去——而两者默认的缩进、引号、括号风格不同，很容易导致“越格式化越乱”。
- 想强制统一使用
prettier，除了勾选项，还需在项目根目录放置.prettierrc，否则它会使用自身默认规则，与团队eslint配置冲突 - HTML 中
js-beautify默认会把短标签（比如）强行换行，想禁用需修改config.cson：atom-beautify: { html: { wrapLineLength: 0 } } - 快捷键
Ctrl+Alt+B常被其他插件劫持（比如emeraldwalk:run-in-terminal），可以在Keymap设置页搜索beautify确认绑定是否还在
最容易被忽略的点：grammar 识别、CLI 工具 PATH、语言级 beautify_on_save 开关——这三项必须同时满足，atom-beautify 才能真正进入工作状态。少一个，它就会安静得像从未安装过一样。
