不妥协的代码格式化工具¶

“任何你喜欢的颜色。”

通过使用 Black，您同意放弃对手动格式细节的控制。作为回报，Black 为您提供速度、确定性和摆脱 pycodestyle 对格式的唠叨。您将节省时间和脑力，用于更重要的事情。

Black 通过产生尽可能小的差异来使代码审查更快。无论您阅读的是哪个项目，格式化的代码看起来都一样。一段时间后，格式化变得透明，您可以专注于内容而不是格式。

立即使用 Black Playground 试用它。

注意 - Black 现在稳定了！

Black 被许多大小项目成功使用。Black 有一个全面的测试套件，包含高效的并行测试、我们自己的自动格式化和并行持续集成运行器。现在我们已经变得稳定，您不应该期望将来格式发生重大变化。风格上的变化主要是对错误报告和对新 Python 语法的支持的响应。

此外，作为一项减慢处理速度的安全措施，Black 会检查重新格式化的代码是否仍然产生有效的 AST，该 AST 等效于原始代码（有关详细信息，请参阅务实部分）。如果您有信心，请使用 --fast。

注意

展示您的风格¶

在您的项目的 README.md 中使用徽章

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

在 README.rst 中使用徽章

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black

看起来像这样

用户指南

开发