Atom Beautify 默认不启用，需手动启用插件、配置语言支持、安装对应CLI工具（如js-beautify）、设置正确grammar，并按语言开启beautify_on_save才能正常工作。
Atom Beautify 不是开箱即用的“点一下就变好看”工具，它默认只认常见后缀（.js、.html、.css），且依赖外部 CLI 工具——装完插件不等于能用，不配好语言支持和底层美化器，右键菜单里压根不会出现「Beautify」选项。
atom-beautify 为什么右键没反应？
最常见原因是 Atom 根本没识别出当前文件的语言类型：
- 看右下角状态栏显示的 grammar 名称：如果是
Plain text、Source或Null Grammar，那 atom-beautify 就会直接跳过——点快捷键或右键都无效 - 点击该 grammar 名称，手动选成
JavaScript、HTML、CSS等对应类型；对无后缀文件（如Dockerfile、.env），需在Config → Core → File Types中加映射，例如："Dockerfile": ["source.dockerfile"] - 某些语法（如
.vue、.jsx）默认不启用支持，必须进Packages → atom-beautify → Settings → Languages手动勾选对应项
格式化失败提示 "beautifier not found" 怎么办？
atom-beautify 本身不干活，它只是个调度器，背后靠 js-beautify、prettier、uncrustify 这类 CLI 工具执行实际美化。报这个错，说明你缺了对应命令行程序：
- JS/HTML/CSS：运行
npm install -g js-beautify（推荐）或npm install -g prettier - Python：需装
autopep8或black，并确保命令可被 Atom 调用（PATH 正确） - C/C++：得装
uncrustify，解压后把uncrustify.exe（Windows）或可执行文件路径加进系统PATH - 装完别忘了重启 Atom 全进程——仅禁用再启用插件不够
Ctrl+Alt+B 快捷键没反应或格式乱套？
快捷键冲突和引擎切换是两大隐形坑：
-
Ctrl+Shift+B是默认键，但常被其他插件（如emeraldwalk:run-in-terminal）劫持；可在Keymap设置页搜beautify确认绑定是否还在 - JS 默认走
js-beautify，但若你全局装了prettier并勾了Use Prettier when available，它就会自动切过去——而两者默认缩进、引号、括号风格不一致 - 想强制统一用
prettier，除了勾选项，还得在项目根目录放.prettierrc，否则它用自身默认规则，跟团队eslint配置容易打架 - HTML 里
js-beautify默认会把短标签（如<div></div>）强行换行，想禁掉得手动改config.cson：加一行atom-beautify: { html: { wrapLineLength: 0 } }
如何让保存时自动格式化生效？
这个功能是按语言开关的，不是全局一键开：
- 进
Packages → atom-beautify → Settings，往下拉找到具体语言（如JavaScript、CSS），勾选beautify_on_save - 注意：它只对当前 grammar 识别正确的文件生效；如果文件是
.ts却被识别为TypeScriptReact，而设置里只开了TypeScript的自动格式化，那就不会触发 - 想整个项目统一风格？优先建
.jsbeautifyrc（JSON 格式），放在项目根目录，atom-beautify 会自动读取——比插件 UI 里的设置优先级更高
真正麻烦的从来不是装插件，而是搞清 grammar 识别、CLI 工具链、配置文件优先级这三层嵌套关系。一个 .vue 文件格式化失败，可能卡在其中任意一层，得顺着状态栏 → 插件设置 → 命令行环境 → 项目配置逐层排查。
