atom-beautify没反应需先检查右下角language-id是否正确，如.vue文件须设为Vue Component而非HTML；格式化报错因依赖未用apm install安装；beautify_on_save失效可能因忽略路径、debounce过短或插件冲突。
atom-beautify 没反应？先看右下角 language-id 是不是对的
Atom 不靠文件后缀判断语言，而是靠 grammar（即右下角显示的 language-id）。atom-beautify 只对它认出的语言生效，否则按 Ctrl+Shift+B 或右键菜单都静默失败。
常见翻车点：
-
.vue文件默认被识别为HTML，导致<script>块不格式化；必须手动点右下角 → 选Vue Component -
.jsx或无后缀文件（如Dockerfile）常被标为Plain text；需在Config → Core → File Types中加映射："Dockerfile": ["source.dockerfile"] - 快捷键失效时，先
Ctrl+Shift+P输入Change Language Mode切换一次再试
格式化报错 “beautifier not found”？别 npm install，用 apm
atom-beautify 本身不带任何格式化引擎，它运行时动态 require('js-beautify') 或 require('prettier')。但 Atom 的 Node.js 环境和你终端里的不是同一个，npm install -g js-beautify 很可能白装。
正确做法：
- 统一用
apm install js-beautify（不是npm）——apm会把模块链入 Atom 运行环境 - 如果已装过但报错，执行
apm rebuild，尤其在 Atom 升级或系统重装后 - Windows 用户若遇 PowerShell 执行策略拦截，临时运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
想保存自动格式化？别只开 Beautify on Save
atom-beautify 的 beautify_on_save 是 per-language 开关，且受多个隐性条件控制。开了没反应，大概率是以下某条拦住了：
-
Ignore VCS Ignored Paths默认开启：文件若在.gitignore里，保存时直接跳过格式化 -
debounce时间太短（默认 300ms）：快速连按Cmd+S只触发最后一次；可设为0测试是否是它导致的漏触发 - 引擎冲突：如果同时启用了
prettier-atom，两个插件都会监听保存事件，结果相互覆盖甚至格式错乱 - 语言配置未展开：进
Packages → atom-beautify → Settings后，得点开具体语言（如 JavaScript）才能看到并勾选它的beautify_on_save
Python/Java/C++ 格式化失败？uncrustify 和 pycodestyle 要配对装
atom-beautify 对非 Web 语言依赖外部 CLI 工具，且安装路径必须能被 Atom 找到。只装工具不配 PATH，等于没装。
关键操作：
- Python：不是装
beautifultable，而是pycodestyle+autopep8或black；推荐apm install python-black插件配合 - C/C++/Java：必须装
uncrustify，Windows 下解压后把uncrustify.exe所在目录加进系统PATH；macOS/Linux 用brew install uncrustify - 装完别忘了在
atom-beautify → Settings → Languages → C++里勾选启用，并确认Beautifier下拉框选的是uncrustify
真正容易被忽略的是：atom-beautify 的配置分散在三个地方——全局设置、语言子项开关、以及外部 CLI 工具自身的配置文件（如 .jsbeautifyrc 或 .uncrustify.cfg）。改了一个地方没效果，大概率是另外两处没同步。
