atom-beautify报错本质是调度器找不到可用工具或未被正确调用：需用apm install安装cli工具、检查grammar识别、逐语言开启beautify on save、禁用冲突插件，并确认keymap与path配置无误。
atom-beautify 报错基本不是插件本身坏了，而是它找不到能干活的工具，或者根本没被正确调用。
报 prettier not found 或 js-beautify not found 怎么办
这类错误说明 atom-beautify 已加载，但背后依赖的 CLI 工具缺失或路径不对。它不走你终端里 npm 全局装的包，而是依赖 apm 环境。
- 别用
npm install -g prettier，改用apm install prettier（注意不是apm install prettier-atom） - 已装过仍报错？运行
apm rebuild，尤其 Atom 升级后必须做这步 - Windows 用户若卡在 PowerShell 执行策略，临时执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 检查 Atom 开发者工具（
Ctrl+Shift+I）控制台，是否有Buffer is not a function—— 这是旧版 js-beautify 兼容问题，必须升级 atom-beautify 到 v0.33.4+
按 Ctrl+Alt+B 没反应，Keybinding Resolver 里也空白
Atom 根本没收到按键，问题不在插件配置，而在系统层或输入法。
- 先按
Ctrl+.唤出 Keybinding Resolver，再按Ctrl+Alt+B，看顶部是否显示任何匹配项 - 如果完全空白：检查 macOS 系统快捷键是否占用了该组合；中文输入法（如搜狗）常劫持
Ctrl+Alt+*，切英文输入法再试 - 远程桌面（ToDesk/TeamViewer）会吞掉修饰键，Resolver 必然无记录
- 确认
keymap.cson文件语法正确：字符串必须单引号、缩进用 2 空格、末尾不能多逗号；路径是~/.atom/keymap.cson（macOS/Linux）或%USERPROFILE%\.atom\keymap.cson（Windows）
右下角显示 Plain text 却弹 beautifier not found
这不是工具没装，是 atom-beautify 根本没启动 —— 它只对明确 grammar 的文件响应，Plain text 类型直接跳过，连报错都不会抛。
- 手动点击右下角 language-id → 选
JavaScript、CSS、Vue Component等具体类型，别留Plain text或Auto - .vue 文件常被识别为 HTML，必须手动切到
Vue Component；.jsx、Dockerfile 等需进Config → Core → File Types手动加映射，例如："Dockerfile": ["source.dockerfile"] - 空文件、开头无
"use strict";、含非法 BOM 字符，都可能导致 grammar 识别失败
保存时没格式化，但 Beautify On Save 明明勾了
这个开关是按语言隔离的，不是全局总闸。勾了 JavaScript 的，不代表 CSS 或 PHP 就自动生效。
- 进
Packages → atom-beautify → Settings，向下滚动找到具体语言区块（如JavaScript、CSS、PHP），每个都要单独勾选Beautify On Save - 确认文件没被
.gitignore覆盖 —— 插件默认开启Ignore VCS Ignored Paths，忽略路径下的文件直接跳过 - 多个格式化插件共存（如
prettier-atom）会抢core:save钩子，只留一个测试；prettier-atom默认优先级更高，容易静默拦截 - debounce 时间太短（默认 300ms）会导致快速连按
Cmd+S只触发最后一次，可临时设为 0 测试
最常被忽略的一点：atom-beautify 是调度器，不是引擎。它不自带任何格式化能力，所有报错都在指向“谁来干”和“能不能干”，而不是“怎么干”。查错顺序永远是：grammar 是否正确 → CLI 工具是否 apm 安装到位 → 语言专属开关是否打开 → 其他插件是否抢占钩子。
