atom本身无格式化能力，保存自动格式化必须依赖插件，且首要前提是右下角grammar显示正确语言（如javascript），若为plain text则插件直接跳过；prettier-atom与atom-beautify不可共存，否则触发冲突导致缩进抖动或代码错乱。
Atom 本身不带格式化能力，保存时自动整理代码必须靠插件驱动，且核心触发条件不是“勾了开关”，而是右下角显示的 grammar 必须匹配目标语言（如 JavaScript），否则 prettier-atom 或 atom-beautify 根本不会运行。
右下角 grammar 显示 Plain Text 就别指望自动格式化
这是 90% 的“保存没反应”问题根源。Atom 不看文件扩展名，只认右下角状态栏显示的语法名。哪怕你打开的是 index.js，只要显示 Plain text 或 Auto，格式化插件就直接跳过。
- 手动修复：点击右下角语法名 → 从列表中选对语言（如
JavaScript、TypeScript） - 常见诱因：文件开头无
"use strict";、内容为空、含非法 BOM 字符、或后缀如.mjs未被默认识别 - 验证法：按
Ctrl+Shift+P输入Atom Beautify: Beautify Editor或prettier:format，能手动执行说明插件正常，问题纯属 grammar 未识别
prettier-atom 和 atom-beautify 别共存
二者注册同一 core:save 钩子，但 Atom 只让第一个响应者执行，后者被静默丢弃。同时启用会导致缩进抖动、分号反复增删，甚至保存后代码变乱。
- JS/TS/React/Vue 项目优先用
prettier-atom：它严格读取.prettierrc，和 ESLint 集成稳，不用装额外 CLI 工具 - Python/PHP/SQL 混合项目用
atom-beautify：它背后调用python-beautify、php-cs-fixer等，但 PHP/Python 的Beautify On Save开关需在插件设置里单独勾选 - 禁用所有其他格式化插件再测试，尤其是
prettier-atom—— 它默认优先级更高，哪怕只多写一个点（如.js写成..js）也会失效
.prettierrc 或 .jsbeautifyrc 修改后不生效？重启或重开文件
这些配置文件不支持热更新。改完不重启 Atom 或不关闭重开当前文件，插件仍用旧缓存。
-
.prettierrc优先级高于.editorconfig；若两者冲突（如tabWidth不同），以.prettierrc为准 -
.jsbeautifyrc必须小写、无拼写错误（不是.jsbeautify.json），且不能有 JSON 注释或结尾逗号 - 路径优先级：项目根目录/
.prettierrc> 用户主目录/.prettierrc；但前提是文件在项目最外层目录，子文件夹里的配置不被读取
保存时缩进错乱、行尾空格被删？检查 whitespace 插件和 editorconfig
格式化插件只管结构，而 whitespace 插件默认会删行尾空格，.editorconfig 也可能强制 trim_trailing_whitespace = true，三者叠加就会出现“看起来没动，其实字节已变”的情况。
- 关掉
whitespace插件的Trim Trailing Whitespace（路径：Edit → Preferences → Packages → whitespace → Settings） - 检查项目根目录是否有
.editorconfig，若有，确认其中trim_trailing_whitespace是否为false，尤其[*.md]段落要单独控制 - 缩进混乱往往源于编辑器
Tab Length和插件配置不一致：比如prettier-atom读.prettierrc的tabWidth: 2，但编辑器设了Tab Length: 4且Soft Tabs关闭，结果混用空格和\t
最易被忽略的点是：多个插件（格式化 + whitespace + editorconfig）可能同时修改空白字符，但 Atom 不提示“此刻是谁动了你的空格”。得靠 git diff --ignore-space-at-eol 或 hexdump -C 查真实字节变化，才能锁死源头。
