Ctrl+Alt+B没反应，先确认右下角grammar是否设为目标语言（如JavaScript而非Plain text），并确保对应CLI工具（如js-beautify）已通过apm安装且Atom已重启。
Ctrl+Alt+B 没反应？先确认 grammar 和 CLI 工具是否就位
Atom 不靠文件后缀判断语言，而是依赖右下角显示的 grammar（如 “Plain text” 或 “Source”）。只要不是明确语言类型（如 JavaScript、HTML、CSS），atom-beautify 就完全跳过——快捷键、右键菜单、保存触发全无效。
解决办法：
- 点击右下角
grammar名称，手动选成目标语言；.vue文件常被识别为HTML，导致<script>块不格式化，必须切到Vue Component -
.jsx、Dockerfile、.env等冷门类型需进Config → Core → File Types手动加映射，例如："Dockerfile": ["source.dockerfile"] - 报
beautifier not found？说明 CLI 工具缺失。atom-beautify只是调度器，JS/HTML/CSS 依赖js-beautify或prettier，Python 依赖autopep8或black，C/C++ 必须用uncrustify - 安装 CLI 工具必须用
apm install js-beautify（不是npm），否则 Atom 运行环境找不到模块；装完必须重启 Atom 全进程（关掉所有窗口再重开）
beautify_on_save 开了却没反应？它是按语言隔离的开关
这个设置不是全局开关，而是每个语言独立控制。开了 JavaScript 的 beautify_on_save，但没勾 HTML，那 .html 文件保存时就完全静默。
操作路径：
-
Packages → atom-beautify → Settings，向下滚动找到具体语言区块（如JavaScript、CSS、HTML） - 每个语言区块里都有独立的
Beautify On Save复选框，必须一个个手动勾上 - C/C++ 等语言即使勾了，也得在对应语言设置里填
Config Path指向uncrustify可执行文件路径，否则仍不触发 - 默认开启
Ignore VCS Ignored Paths：如果文件在.gitignore里，保存时直接跳过格式化
配置文件（.prettierrc / .jsbeautifyrc）和 UI 设置谁生效？
配置文件会覆盖 UI 设置，但仅限它明确声明的字段；未声明项仍回退到 UI 值。团队协作中容易因此风格打架。
注意细节：
-
.jsbeautifyrc必须是合法 JSON，字段名严格区分大小写：indent_size有效，indentSize被忽略 - 若用了
prettier，建议项目根目录放.prettierrc；否则它走自身默认规则（2 空格、单引号、不加分号），容易和团队eslint风格冲突 -
.editorconfig会被读取，但只影响缩进、换行等基础项，不接管括号风格或引号逻辑
文件编码不是 UTF-8？atom-beautify 会静默失败
这是最容易被忽略的硬性前提。GBK、ISO-8859-1 等编码下，atom-beautify 不报错、不提示、也不格式化，直接跳过。
检查与修复：
- Atom 右下角状态栏会显示当前编码（如
UTF-8、GBK），点击可切换 - 批量转码可用命令行：
iconv -f GBK -t UTF-8 input.js > output.js - 新文件默认编码可在
Config → Core → Default Encoding设为utf8
真正卡住人的地方，往往不在“怎么装”，而在“它认不认你当前这行代码”。语法识别、CLI 可执行性、语言级开关、配置文件合法性、文件编码——五者缺一不可。
