Atom本身不带格式化能力，必须安装atom-beautify或prettier-atom插件并正确配置：JS/TS/React/Vue项目优先选prettier-atom（遵循.prettierrc），多语言混合项目选atom-beautify；二者不可共存于同一文件类型，且需统一编辑器缩进设置与插件配置，否则导致格式错乱。
Atom 本身不格式化代码，所谓“排版好看”完全取决于你装了什么插件、怎么配、以及当前文件是否被正确识别——装完 atom-beautify 或 prettier-atom 不等于自动变整齐，漏掉任一环节，Ctrl+S 就只是保存，不会动一行缩进。
atom-beautify 和 prettier-atom 到底该选谁
看项目语言构成和团队规范，不是看哪个名字更响亮：
- JS/TS/React/Vue 为主 + 已有
.prettierrc或 ESLint 集成 → 用prettier-atom，它严格按 Prettier 规则走，不会擅自加/删分号 - Python/PHP/SQL/HTML 混合项目，或没统一配置文件 → 用
atom-beautify，它背后调用js-beautify、autopep8、uncrustify等独立工具链，语言支持更广 - 二者不能共存于同一文件类型：比如同时启用
atom-beautify和prettier-atom处理.js文件，会触发两次格式化，结果错乱甚至报错
右键没 “Beautify” 选项？先查 grammar 和 CLI 工具
这不是插件坏了，而是 atom-beautify 根本没认出这是可处理的文件：
- 看右下角状态栏显示的 grammar：如果是
Plain text、Source或Null Grammar，插件直接跳过——点击它，手动选成JavaScript、CSS等真实类型 - 对
.jsx、.vue、.env这类文件，需进Packages → atom-beautify → Settings → Languages手动勾选支持 - 报
beautifier not found？说明缺底层 CLI 工具：
– JS/HTML/CSS：运行npm install -g js-beautify或npm install -g prettier
– Python：装autopep8或black，并确保终端能执行autopep8 --version
– C/C++：下载uncrustify可执行文件，把路径加进系统PATH - 装完 CLI 工具必须重启 Atom 全进程（不只是禁用再启用插件）
保存时自动格式化为什么没反应
因为 beautify_on_save 是按语言隔离的开关，不存在“一键全局开启”：
- 进
Packages → atom-beautify → Settings，向下滚动找到具体语言区块（如JavaScript、CSS、HTML） - 每个区块里都有独立的
Beautify On Save复选框，必须一个个勾上；开了 JS 却没开 CSS，那.css文件保存时就完全没变化 - 如果用了
prettier-atom，要勾选其设置页的Format on Save，并确认File Extensions包含目标后缀（如["js", "ts", "css"]，注意不带点） - 即使都开了，若当前文件编码不是 UTF-8（比如是 GBK），
atom-beautify会静默失败——遇到无响应，先查右下角编码显示
对齐冒号、缩进错乱、快捷键失灵这些细节怎么调
这些不是 bug，是插件行为和编辑器设置没对齐：
- 冒号对齐（如字典 key-value）要用
aligner-python或aligner-json，只装atom-aligner无效；且必须选中干净的 key-value 行，不含{、}、注释或空行 - 缩进错乱常见原因：
– 编辑器Tab Length设为 4，但插件配置写的是 2 空格
–atom-beautify设置页里Indent With Tabs没关（应设为false）
– 右下角显示Tab: hard，而对齐插件只处理空格 -
Ctrl+Alt+B没反应？默认键可能被其他插件劫持（如emeraldwalk:run-in-terminal），去Keymap设置页搜beautify确认绑定是否还在 - 格式化后引号、分号、括号风格不对？检查是否启用了
Use Prettier when available，它会自动切引擎——而js-beautify和prettier默认规则不一致
最容易被忽略的是：格式化行为依赖当前文件是否在项目根目录下。如果只是单独打开一个 .js 文件，没进含 node_modules 和 .prettierrc 的文件夹，prettier-atom 就不会加载插件，declare module 或 @apply 这类语法照样跳过不处理。
