代码检测¶

代码检测是使用一些工具检查代码知否符合 Python 相关规范。

当前主流的代码检测规范包括

代码检测工具¶

black 是 PSF 组织下的一个代码格式化工具。其特点是强制格式化代码，使代码保持一致性。但缺点是会自动调整代码格式。

特点：

flake8 是 pycqa 组织下的一个代码检测工具。它遵循 PEP 8 规范，指示出不符合规范的代码。

特点：

pylint 是 pycqa 组织下维护的工具。它不仅仅是一款代码检测工具，还可以发现变成错误，代码异常，并提供简单的重构建议。

特点：

yapf 是 Google 维护的一个代码检测工具。它和上述工具不同，使用基于 clang-format 的算法将代码重新格式化为复合风格指南的最佳格式。类似于 Golang 的 gofmt 工具。所以它和 black 工具有点类似。

特点：

虽然代码检测工具有很多，但是它们的初衷都是为了让 Python 代码符合一致的风格和规范。只不过是有的工具更激进而已。具有良好编码习惯的开发人员，写出的代码，无论使用哪种工具，都能轻松通过。所以代码检测工具的最终目的是告知开发人员尽可能遵守一致的风格来编写代码。

考虑到代码检测工具的指导性，和功能性，推荐使用 pylint 作为首选检测工具。在实践中发现由于某些库和 pylint 的兼容性问题，当使用 pylint 有问题时，可以使用 flake8 作为替代的检测工具。