在 Ubuntu 里写 Python，代码能运行并不代表已经适合协作。很多项目真正拉开差距的，往往是风格是否统一、修改后是否容易 review，以及团队能不能减少无意义的格式争论。下面就按“怎么装、怎么用、适合谁”的思路，梳理 3 种常见格式化工具，帮你快速判断在本机或团队环境里该选哪一个。
black：想省事、想统一时的首选
如果你的目标是尽快把代码整理到一致风格，black 通常是最省心的方案。它的思路很直接：尽量少给用户风格选择，由工具统一决定排版方式，这样团队里每个人跑出的结果都更接近，也更容易避免“空格怎么加、换行怎么断”这类讨论。
安装命令如下：
pip install black对指定 Python 文件执行格式化：
black your_python_file.pyblack 会自动处理整个文件里的缩进、空格和换行，并尽量让结果符合 PEP 8 的常见要求。对个人脚本来说，它能省掉手工整理时间；对多人协作来说，它最大的价值是把风格统一这件事交给工具，而不是交给人工约定。
yapf：需要可配置风格时更灵活
如果你不想完全接受单一风格，而是希望在统一规范的同时保留一些项目级设置，yapf 会更合适。它出自 Google，特点就是格式化能力之外，还给了开发者比较多的配置空间。
安装同样很直接：
pip install yapf原地修改文件时，可以这样执行：
yapf -i your_python_file.py和 black 相比，yapf 更适合那些已经有明确代码风格偏好的项目。你可以通过 .style.yapf 配置文件调整细节，例如缩进宽度、对齐方式等。这样既能避免纯手工对齐空格的低效做法，也能让格式结果更贴近团队自己的习惯。
autopep8：专注修正 PEP 8 问题
如果你的需求更偏向“把现有代码尽量修到 PEP 8 规范内”，那 autopep8 仍然是一个经典选择。它的定位比较明确，就是围绕 PEP 8 中常见的问题做自动修正。
安装命令：
pip install autopep8执行较强力度的自动修复时，可以使用下面这条命令：
autopep8 --in-place --aggressive --aggressive your_python_file.py这里的两个 --aggressive 表示尝试更多自动修改。不过这也是它最需要谨慎使用的地方：激进模式虽然能修得更多，但在个别情况下也可能带来语义层面的变化。比如某些较长表达式被拆分成多行后，如果代码本身写法比较边缘，就有机会引出逻辑问题。
因此，更稳妥的做法是先在备份文件或受控分支上运行，再检查结果是否符合预期，尤其是在老项目或历史代码较复杂的仓库里。
三种工具怎么选更合适
这 3 款工具都能在 Ubuntu 终端中直接完成格式化，但适用场景并不一样。
适合优先选 black 的情况
如果你看重的是省事、统一和低沟通成本，black 基本就是默认答案。它尤其适合团队协作、代码评审频繁，或者希望新成员接手后立即遵循同一风格的项目。
适合考虑 yapf 的情况
如果项目已经形成一套特定排版习惯，或者你希望对缩进、对齐等细节做更细控制，yapf 的可配置能力会更实用。它不是简单追求“统一到唯一结果”，而是在自动化和个性化之间留出空间。
适合使用 autopep8 的情况
如果你面对的是一批历史代码，主要任务是修正常见 PEP 8 问题，而不是整体切换到某种强约束风格，那么 autopep8 会更贴近这个目标。不过激进修复要留意结果，不能把它当成完全无需复核的“一键清理”。
实际使用建议：终端格式化之外，再加一道自动化
从日常开发角度看，手动执行格式化命令只是第一步。很多团队会把这些工具接到 pre-commit hook 里，在提交前自动完成格式整理。这样做的好处很直接：开发者不用每次都记得手动执行，代码进入仓库前也能先过一遍统一规则。
如果你只是个人开发，直接选一个工具固定下来即可；如果你在团队中协作，最好尽早统一格式化方案。综合来看，图省事、重一致性就选 black；想保留更多自定义能力，可以考虑 yapf；如果主要是按 PEP 8 修整已有代码，则 autopep8 更对路。
