atom本身无格式化能力，需依赖atom-beautify插件；其“保存时自动美化”须按语言逐项启用，且依赖文件语法识别（右下角显示javascript等）、正确后缀、utf-8编码及外部工具（如uncrustify）安装。

Atom 本身不自带代码格式化能力，必须依赖插件；atom-beautify 是目前最稳定、语言支持最广的方案，但它的“自动美化”不是全局开关，而是按语言逐项启用——漏勾一个语言，保存时就完全没反应。

如何确认 atom-beautify 已正确安装并识别当前文件类型

常见错误现象是：按 Ctrl+S 后毫无变化，连缩进都没动。这往往不是插件坏了，而是 Atom 根本没把当前文件当成目标语言处理。

• 看编辑器右下角状态栏，确认显示的是你预期的语言名（比如 JavaScript，而不是 Plain Text 或 Auto）
• 如果显示不对，手动点击该区域，从下拉菜单中选择正确语法（例如 JavaScript → JavaScript）
• 检查文件后缀是否被 Atom 默认识别（.js 没问题，但 .jsx 或 .ts 可能需要额外安装语法高亮包，如 language-babel 或 atom-typescript）

保存时自动格式化必须为每种语言单独开启

atom-beautify 的 beautify_on_save 设置是按语言隔离的，不存在“全部启用”按钮。JavaScript 开了，CSS 没开，保存 .css 文件就永远不会触发美化。

• 路径：Settings → Packages → atom-beautify → Settings
• 向下滚动，找到你常用的语言区块（如 JavaScript、CSS、HTML）
• 每个区块里都有独立的 Beautify On Save 复选框，必须一个个勾上
• C/C++ 等语言默认不带内置美化器，需额外装 uncrustify 并在对应语言设置里填入 Config Path，否则勾了也无效

配置文件优先级与常见冲突点

项目根目录下的 .jsbeautifyrc 会覆盖插件 UI 中的设置，但只影响匹配的语言；而 .editorconfig 是跨编辑器通用规则，atom-beautify 会读取它，但仅用于缩进、换行等基础项，不接管括号风格或空格逻辑。

• .jsbeautifyrc 必须是合法 JSON，字段名严格区分大小写（例如 indent_size 有效，indentSize 会被忽略）
• 如果 UI 设置和 .jsbeautifyrc 冲突，以配置文件为准；但若配置文件里没写某项（如 max_preserve_newlines），仍会回退到 UI 设置
• 某些语言（如 Python）的格式化实际由外部工具（autopep8、black）驱动，atom-beautify 只负责调用——此时要确保对应命令行工具已安装且可在终端中直接执行

最容易被忽略的是：即使所有设置都对，如果当前文件编码不是 UTF-8（比如是 GBK 或 ISO-8859-1），atom-beautify 会静默失败，不报错也不格式化。遇到无响应时，先查编码。