pytest-flake8是将flake8静态检查集成到pytest中的插件，使代码风格检查与单元测试共用同一命令、报告和退出码，但不检测逻辑错误；它默认仅扫描测试文件，需显式指定源码路径，并依赖flake8自身配置（如pyproject.toml中[tool.flake8]）控制规则。
pytest-flake8 是什么，它能做什么
它不是独立运行的 flake8，而是把 flake8 作为 pytest 的一个插件集成进来，让代码风格检查（PEP 8、未使用变量、未定义名称等）和单元测试跑在同一个命令里，统一报告、统一退出码。但它**不检测逻辑错误**——这是常见误解。它只做静态分析，和 pytest 本身负责的运行时逻辑测试是两回事。所谓“双重检测”，其实是并行执行：一边跑测试用例，一边扫代码风格问题。
安装与基础配置要避开的坑
直接 pip install pytest-flake8 就够了，但容易忽略三点：
- 必须同时安装
flake8（pytest-flake8不自动带它），否则运行时报错ModuleNotFoundError: No module named 'flake8' - 默认只检查
test_*.py和*_test.py文件，**不会扫描你的源码目录**（比如src/或myapp/）。想检查业务代码，得显式指定路径或改配置 -
pytest默认跳过.git、__pycache__等目录，但flake8插件不会自动继承这些规则，可能报一堆无关警告
推荐在 pyproject.toml 中声明检查范围：
[tool.pytest.ini_options]
# 同时跑测试和 flake8 检查
addopts = ["--flake8", "src/", "tests/"]
# 避免重复扫描构建产物
flake8-ignore = [
"*/migrations/*",
"*/__pycache__/*",
"*/venv/*",
]如何让 flake8 规则适配项目实际需要
pytest-flake8 用的是底层 flake8 的配置，所以规则控制全靠 flake8 自己的配置项，不是 pytest 插件独有逻辑。关键点：
立即学习“Python免费学习笔记（深入）”；
- 规则开关写在
[tool.flake8]下（pyproject.toml），不是[tool.pytest]里 -
select和ignore不能共存；如果用了select，就得手动列出所有想开的规则（比如E501,W503），漏掉的就不会报 - 禁用某条规则，用
extend-ignore更安全（它追加到默认 ignore 列表后），而不是直接覆盖ignore - 注意
max-line-length：pytest-flake8不读pycodestyle配置，只认flake8的max-line-length字段
示例片段：
[tool.flake8] max-line-length = 88 extend-ignore = "E203, W503" # 不要写成 ignore = "E203, W503" —— 这会清空 flake8 默认 ignore
CI/CD 中失败阈值怎么设才合理
--flake8-max-complexity、--flake8-max-line-length 这类参数只是透传给 flake8，真正影响 CI 是否失败的是整体退出码。关键行为：
- 只要有任何一条 flake8 警告（warning），
pytest就返回非零退出码（默认是 1），CI 就失败 - 想放宽，只能用
--flake8-quiet（完全关闭 flake8 输出）或--flake8-ignore（命令行临时忽略某些 code），但不推荐 - 更稳妥的做法：在
pyproject.toml里用flake8-ignore精确屏蔽已知可接受的问题（比如生成的 protobuf 文件），而不是调高阈值 - 别依赖
--flake8的--exit-nonzero-on-report—— 它已被废弃，新版 flake8 不再支持
复杂点在于：你没法只对 style 错误“降级为 warning”，而对 test failure 仍严格 fail。它们共享同一个 pytest 退出流程。真要区分，得拆成两个独立步骤：flake8 src/ + pytest tests/。
