linter-flake8 仅执行静态检查，不修改代码，故无法自动格式化；要实现PEP8一键排版，需安装python-autopep8插件并配置其指向已安装的autopep8 CLI路径，启用Format on save或使用Ctrl+Alt+B快捷键。
Atom 默认不自动排版 Python 代码，必须靠插件 + 显式配置才能真正兼容 PEP8 —— 光装 linter-flake8 只能报错，不能修复；想一键格式化，得用 python-autopep8 或 atom-beautify 配合 autopep8 命令行工具。
为什么 linter-flake8 不能自动格式化？
它只是个“检查员”，不是“修理工”。linter-flake8 会高亮 E225（运算符缺空格）、E302（函数间少空行）等错误，但不会改你的代码。
- 常见现象：保存后仍看到红色波浪线，Ctrl+S 没反应，右键菜单里没有“格式化”选项
- 根本原因：该插件只调用
flake8的--stdin-display-name模式做静态扫描，不触发重写逻辑 - 如果你已装
flake8但没装pycodestyle或autopep8，连基础检查都可能失败（报Command not found: flake8或路径解析异常）
怎么让 Ctrl+Alt+B 或保存时自动按 PEP8 排版？
推荐用 python-autopep8 插件，它直接封装了 autopep8 CLI，支持 on-save 和手动触发两种模式。
- 先在终端执行：
pip install autopep8（确认which autopep8能返回路径，如/usr/local/bin/autopep8） - Atom 中安装插件：
python-autopep8（不是linter-python-pep8，后者已弃用） - 进插件设置页，填入
autopep8可执行文件路径（Windows 用户注意：别漏掉.exe后缀，比如C:\Python39\Scripts\autopep8.exe） - 勾选
Format on save，或手动按快捷键ctrl-alt-b（默认绑定，可在 Keymap 中查证）
atom-beautify + autopep8 组合的坑在哪？
这个组合看似灵活，实则容易失效——因为 atom-beautify 对 Python 的支持依赖后端选择，而它的默认 Python 格式化器是 autopep8，但不会自动检测你是否装了它。
立即学习“Python免费学习笔记（深入）”；
- 典型失败场景：装了
atom-beautify，也装了autopep8，但按ctrl-alt-b没反应，控制台报No formatter found for python - 解决办法：打开
atom-beautify设置 → 找到Python语言块 → 把Formatter显式设为autopep8，再确认Executable path填对 - 额外注意：
autopep8的--aggressive参数会影响行为——加一次可能补空格，加两次才拆长行、合并短 if；插件 UI 通常不暴露该参数，得改插件源码或换用命令行调用
缩进和空格必须手动对齐吗？
不用。Atom 本身就能强制统一用 space，这是 PEP8 明确要求的（E111、E128 类错误源头）。
- Settings → Editor → 勾选
Soft Tabs，设Tab Length为4 - 已有文件中混用 tab 和 space？用
whitespace插件一键转换：whitespace:replace-tabs-with-spaces（命令面板调出） - 关键细节：即使开了 soft tabs，粘贴外部代码时仍可能带入硬 tab —— 建议开启
whitespace:remove-trailing-whitespace并勾选Ensure Single Trailing Newline，避免W292和W391报错
真正麻烦的不是装哪个插件，而是每个插件都依赖外部 CLI 工具的路径是否可访问、版本是否匹配（比如 autopep8==2.0.2 不兼容 Python 3.12 的某些语法）。建议先在终端跑通 autopep8 --in-place --aggressive test.py，再回头配 Atom。
