装完 atom-beautify 插件不能直接使用，必须同时满足三条件：正确设置 grammar、安装对应 CLI 工具并加入 PATH、在语言设置中开启 beautify_on_save 开关。
装完 atom-beautify 插件 ≠ 能用。它默认不工作，必须手动配 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。报这个错，就是命令行里根本找不到对应可执行程序。
Prettier 是一款"有主见的"代码格式化工具，通过解析代码并按照统一规则重新格式化，强制执行一致的代码风格。支持 JavaScript、TypeScript、CSS、SCSS、HTML、Vue、JSON、Markdown、YAML 等多种语言。可配置为保存时自动格式化。
- 前端项目：运行
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默认会把短标签（如<div></div>）强行换行，想禁掉得改config.cson：atom-beautify: { html: { wrapLineLength: 0 } } - 快捷键
Ctrl+Alt+B常被其他插件劫持（如emeraldwalk:run-in-terminal），可在Keymap设置页搜beautify确认绑定是否还在
最常被忽略的点：grammar 识别、CLI 工具 PATH、语言级 beautify_on_save 开关，这三项必须同时满足，atom-beautify 才真正进入工作状态。少一个，它就安静得像没装过。
