atom本身不内置代码格式化功能，必须通过插件实现；推荐新项目优先使用prettier-atom（专注prettier生态、结果稳定、与eslint配合顺滑），多语言混合项目可选atom-beautify，但二者不可共存于同一文件类型。
Atom 本身不内置代码格式化功能，必须通过插件实现，且不同语言需要对应格式化工具（如 prettier、eslint、black），光装插件不配底层工具会报错“command not found”。
安装 atom-beautify 或 prettier-atom？选哪个
atom-beautify 支持语言多（HTML/JS/CSS/PHP 等），但配置分散、规则老旧，对现代 JS/TS 支持弱；prettier-atom 专注 Prettier 生态，格式化结果稳定、与团队 ESLint 配合顺滑，推荐新项目优先用它。
- 如果项目已用
prettierCLI 或.prettierrc，直接装prettier-atom，避免格式冲突 - 若需格式化 Python，
prettier-atom不支持，得换atom-python-tools+black或autopep8 -
atom-beautify的js-beautify默认不尊重 ESLint 规则，容易和 CI 检查打架
prettier-atom 报错 “Prettier not found” 怎么办
这是最常见问题：插件只负责调用，不自带 prettier。必须在项目里或全局装好 CLI 工具，并确保 Atom 能访问到它。
- 在项目根目录运行
npm install --save-dev prettier（推荐，避免全局污染） - 确认
prettier-atom设置里的prettierCliPath是空的——插件会自动找node_modules/.bin/prettier - 如果用了 Yarn 2+ 或 pnpm，路径可能失效，改手动填：
./node_modules/.bin/prettier（Linux/macOS）或.\node_modules\.bin\prettier.cmd（Windows） - 重启 Atom，打开开发者工具（
Ctrl+Shift+I）看 Console 是否还有spawn prettier ENOENT
快捷键没反应或只格式化部分代码
默认快捷键 Ctrl+Alt+B（Win/Linux）或 Cmd+Alt+B（macOS）作用于当前光标所在范围：全选才整文件，否则只格式化选中块。这不是 bug，是设计行为。
- 想始终整文件格式化，进
Settings → Packages → prettier-atom → Settings，勾选Format On Save，并关掉Only Format If Prettier Config File Is Found（除非你真依赖.prettierrc） - JSX/TSX 文件没反应？检查
prettier-atom的File Extensions列表是否含tsx、jsx（默认有，但有人手误删过） - 保存后格式化失败却没提示？打开
Settings → Core → Confirm Before Reloading关掉，否则 Atom 可能静默失败
真正卡住的点往往不在 Atom 插件本身，而在 Node 环境路径、包管理器隔离机制、或 Prettier 配置文件位置（比如 .prettierrc 放错父目录导致插件读不到）。先跑通 npx prettier --write src/App.js 再回头调 Atom，省一半时间。
