Black

GItHub | 官方文档 | PyPI | 在线试用

Black 自称“零妥协代码格式化工具（The uncompromising code formatter）”。

截止到 2022 年 11 月，Black 已经在 GitHub 斩获 30.3k 个 Stars，由 Google 开发维护的 YAPF 为 12.9k ，而 autopep8 则只有 4.2k 。可以说 Black 是目前最广受好评的 Python 代码格式化工具。

作者给 black 的定义是「The Uncompromising Code Formatter」，也就是「不妥协的代码格式化程序」。什么意思呢，一句话：你要听它的，由 black 按照它的审美帮助你处理代码格式问题。black 的格式化规则是 PEP8 的超集，也就是除了处理成符合 PEP8 规范要求的代码，也有 black 的一些规则。

实际使用上，black 确实简洁，无需配置，人狠话不多

Python有一个官方建议的排版规范，叫做PEP 8: Style Guide for Python Code，是Python社区内排版的惯例。Black完全遵循这个规范，包括但不限于：

• 使用4个空格缩进（每一级）
• 每一行代码长度不超过79个字符
• 用两行空行分隔顶层的函数和类定义

等等。

Black本身是用python写的可执行脚本。安装非常的简单，用pip就可以

pip install black

安装完成之后，对想要重新排版的文件使用如下命令

black source.py

即可完成排版。注意，上述命令会覆盖原文件。