摘要：Flake8 是一款轻量级 Python 静态代码分析工具，融合了多种检查器，可快速发现代码中的风格违规、语法问题和潜在错误，适合开发初期与持续集成场景使用。
Flake8 是一款轻量级 Python 静态代码分析工具，融合了多种检查器，可快速发现代码中的风格违规、语法问题和潜在错误，适合开发初期与持续集成场景使用。
安装 ：
pip install flake8安装完成后，即可通过命令行工具 flake8 使用。
常见应用场景：
（1）日常开发阶段：在保存文件时快速检测编码风格或拼写问题。
（2）团队协作阶段：统一代码风格标准，减少审查歧义。
（3）持续集成流程：集成于 GitHub Actions、GitLab CI 等平台自动分析每次提交。
（4）教学与学习阶段：辅助新手遵循 PEP 8 编码规范。
（5）发布前审查阶段：确保无明显风格问题或未定义变量。
◆◆ ◆
核心概念
1、轻量化分析框架
Flake8 是对多个工具的封装，核心包括：
PyFlakes：是一个 linter，与 相似，旨在更快地工作并避免误报。它还忽略了由下一个工具处理的样式规则。
pycodestyle：是一个风格检查器，检查代码风格是否符合 PEP 8。
McCabe：用于检查分析函数/模块的圈复杂度。其本质就是在你的代码结构过于复杂时警告你。
2、只检查、不评分
与 Pylint 不同，Flake8 不对代码打分，而是专注于问题检测和报告。
3、插件机制
支持扩展插件（如 flake8-docstrings, flake8-import-order）以适应不同项目需求。
4、易集成性
支持集成于 VSCode、PyCharm、CI 工具链等开发或部署环境。
◆◆ ◆
基本用法
创建一个文件 example.py：
def add(a, b):result = a + breturn resultx = add(1, 2)print(x)flake8 example.py若没有错误或风格问题，不会有任何输出。
def add(a, b):result = a + bx = add(1, 2)print(x)则可能输出：
◆◆ ◆
应用举例
例 1： 忽略某些检查项
可以通过命令行或配置文件忽略指定规则。
flake8 example.py --ignore=E302,W292提示：
如果省略了错误代码， noqa 将导致 flake8 忽略该行的所有错误。
例 2：配置 .flake8 文件
在项目根目录创建 .flake8 配置文件：
[flake8]max-line-length = 88ignore = E203,W503exclude = venv,__pycache__运行时将自动读取此配置。
例 3：与 VSCode 集成
在 settings.json 中添加：
{"python.linting.enabled": true,"python.linting.flake8Enabled": true}保存文件后可自动检测。
例 4：复杂度分析
默认最大复杂度为 10，可通过参数修改限制。
flake8 --max-complexity=8 your_file.py默认情况下，Flake8 只运行 PyFlakes 和 pycodestyle。若要分析代码的复杂度，则还需要传递参数 --max-complexity。
◆◆ ◆
常用命令参数解释
--ignore=错误代码列表
忽略指定的检查规则。例如：--ignore=E203,W503。
--select=错误代码列表
仅启用指定的检查规则。例如：--select=E9,F63。
--max-line-length=数字
设置每行代码的最大字符数，默认 79，常见设为 88（与 Black 保持一致）。
--exclude=路径列表
排除不检查的目录或文件，如虚拟环境或缓存目录。
--max-complexity=数字
设置 McCabe 圈复杂度上限，函数结构越复杂，值越高。
--count
显示问题数量统计。
--statistics
显示每种问题的统计信息。
--config=路径
指定自定义配置文件路径，覆盖默认 .flake8 设置。
◆◆ ◆
补充说明
1、Flake8 检查范围不包含类型注解，如需类型检查可结合 mypy 使用。
2、Flake8 与 Black 冲突项可通过 ignore=E203,W503 在 .flake8 中规避。
3、常见组合：Black + Flake8 + isort 可实现高效、规范的开发流程。
4、Flake8 不检查文档字符串（docstring）或导入顺序，需手动安装对应插件如：
flake8-docstrings
flake8-import-order
5、Flake8 相对于 Pylint 的优势之一是文档，它有警告、错误、选项等完整列表。
“点赞有美意，赞赏是鼓励”
来源：小胡科技每日一讲
