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

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 才能真正进入工作状态。少一个，它就会安静得像从未安装过一样。