在Atom编辑器里安装Beautify代码美化插件的详细教程

装完 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。报这个错，就是命令行里根本找不到对应可执行程序。

• 前端项目：运行 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 才真正进入工作状态。少一个，它就安静得像没装过。