Python 进阶 — Flake8 静态代码检查工具

2022-05-29 IT知识 Python 代码检查

学向勤中得，萤窗万卷书。这篇文章主要讲述Python 进阶 — Flake8 静态代码检查工具相关的知识，希望能为你提供帮助。

目录

文章目录

??目录??
??Flake8??
??错误返回码??
??安装??
??使用??
??插件??

Flake8Flake8 是由 python 官方发布的一款静态代码检查工具（https://pypi.python.org/pypi/flake8/），相对于 PyLint 而言，Flake8 的检查规则灵活，支持集成额外插件，扩展性强。
Flake8 是对下面 3 个工具的封装：

PyFlakes：静态检查 Python 代码逻辑错误的工具。
PEP8：静态检查 PEP8 编码风格的工具。
NedBatchelder’s McCabe：静态分析Python代码复杂度的工具。

错误返回码Flake8 的基础错误返回码一共有 3 类：

Fxxx：PyFlakes 返回的代码逻辑错误 Error。
Exxx、Wxxx：PEP8 返回的编码规范 Error 和 Warning。
C9xx：McCabe 返回的代码复杂度。通过 Flake8 的 --max-complexity 选项可以设定 McCabe 的函数复杂度数值，高出则告警。Flake8 建议值为 12。

安装

$ python -m pip install flake8
$ flake8 –help

使用

直接使用：

$ cd /project_path/
$ flake8 .

通常的 flake8 会集成到 tox 一同更方便使用：

[tox]
minversion = 2.0
envlist = pep8

[testenv:pep8]
commands =
flake8

展示特定错误码：

# e.g. 以 E 开头
flake8 --select E project_path

# e.g. H233
flake8 --select H233 project_path

忽略特定错误码：

# e.g. H233
flake8 --ignore H233 project_path

# e.g. 忽略检查 test1.py 文件
flake8 --exclude project_path/path2/test1.py project_path

【Python 进阶 — Flake8 静态代码检查工具】

输出修改格式：

flake8 --format=%(path)s::%(row)d,%(col)d::%(code)s::%(text)s project_path

插件Flake8 相比其他 Python 静态代码检查工具的优势在于其良好的扩展性，以下介绍几款比较流行的插件：

hacking：根据 OpenStack Style Guidelines 产生，官方文档：https://pypi.python.org/pypi/hacking，错误返回码以 H 开头。

pip install hacking

flake8-chart：可视化插件，将 flake8 的分析结果转化为图形。

flake8 --statistics shadowtest |flake8chart--chart-type=BAR --chart-output=shadow.svg

推荐阅读

上一篇：如何理解Debian仓库地址

下一篇：Java编程中忽略这些细节，Bug肯定找上你