无懈可击的代码格式化工具¶

“任何你喜欢的颜色。”

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

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

现在就使用 Black Playground 试用它。

注意 - Black 现在已稳定！

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

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

注意

感言¶

Mike Bayer，SQLAlchemy 作者

我无法想象在我整个编程生涯中，有任何工具像 Black 一样，在引入后能给我带来如此巨大的效率提升。现在，我可以使用以前 1% 的按键次数来进行重构，而以前我们没有办法让代码自己格式化。

Dusty Phillips，作家

Black 有自己的想法，所以你不必有。

Hynek Schlawack，attrs 创建者，Twisted 和 CPython 核心开发者

一个不差劲的自动格式化工具，这就是我想要的圣诞礼物！

Carl Meyer，Django 核心开发者

至少这个名字不错。

Kenneth Reitz，requests 和 pipenv 创建者

这极大地改善了我们代码的格式。非常感谢！

在你的项目的 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

看起来像这样

用户指南

开发