Python 工程的最佳伴侣：isort、flake8、black 和 mypy

在 Python/ target=_blank class=infotextkey>Python 项目开发过程中，我们经常需要一些工具来帮助我们保持代码质量，提高开发效率。今天，我们要介绍四个 Python 工程的最佳伴侣：isort、flake8、black 和 mypy。

01 isort：让导入看起来整齐

isort 是一个 Python 工具，可以自动在 Python 文件中排序和格式化 import 语句。它可以帮助我们确保所有的 import 语句都遵循相同的标准，使得代码看起来更清晰，更易于阅读。

02 flake8：代码风格一致性

flake8 是一个 Python 代码风格检查工具。它可以帮助我们发现代码中的风格问题，例如行长度过长、不符合 PEP8 标准的命名、未使用的变量等问题。通过使用 flake8，我们可以确保代码风格的一致性，提高代码的可读性。下面让我们通过一个示例来看一下 Flake8 是如何工作的。

首先，我们需要一个有一些风格问题的 Python 代码。假设我们有以下的代码：

这段代码虽然可以正确运行，但是它不符合 PEP 8 的代码风格规定。比如，函数参数列表中的逗号后应该有一个空格，而不是前面；return 语句后的运算符两侧应该都有空格。

接下来，我们可以使用 Flake8 来检查这段代码。运行以下命令：

flake8 example.pyFlake8 会输出以下信息：

这里，E201、E202 和 E225 是 Flake8 针对不同类型问题的错误代码。你可以在 Flake8 的规则列表 中找到这些错误代码的详细解释。

有了这些错误信息，我们就可以逐一修正代码中的问题，使之符合 PEP 8 的规定：

只能告诉你，哪里的代码风格不符合规范，我们要手动改，非常难受， 下面这个工具black就可以自动帮我们格式化代码符合python规范。

03 black：自动化代码格式化

black 是一个 Python 代码自动格式化工具。你可以把它看作是一个“无需配置”的 flake8，它会自动把你的代码格式化到 PEP 8 标准。这意味着我们可以花更少的时间在代码格式化上，而将更多的精力放在解决实际的问题上。

需要注意的是， black 有一个默认的行长度限制(88个字符)，这可能会和 fake8 的默认行长度限制(79个字符)冲突。如果你想一起使用这两个工具，你可能需要在 flake8 的配置文件中设置 max-line-length = 88 ，以避免不必要的冲突。或者把 black 改成79个字符。如在python项目中的 pyproject.tom1 中进行统一配置：

04 mypy：静态类型检查

mypy 是一个 Python 静态类型检查工具。虽然 Python 是一门动态类型的语言，但在某些情况下，使用静态类型可以帮助我们发现潜在的问题。mypy 可以检查我们的代码，确保我们的类型注解是正确的。

$ mypy my_script.pymy_script.py: note: In function "greeting":my_script.py:2: error: Argument 1 to "greeting" has incompatible type "int"; expected "str"在 Python 项目开发过程中，isort、flake8、black 和 mypy 是我们的最佳伴侣。它们可以帮助我们维护代码质量，提高开发效率。本文仅仅告诉你他们最基本的使用， 在生产的时候，我们可以把他们安装到我们的IDE，如pycharm，vscode。也可以结合到CICD的流程，让大家的代码风格规范都统一起来。