pytest --flake8 默认不失败，因插件将lint结果转为普通测试用例并启用--flake8-quiet，仅输出summary；需显式配置--flake8-max-line-length等参数或--strict-markers才能触发失败中断。
直接用 pytest --flake8 就能跑，但默认不报错、不中断构建，容易误以为检查生效了——其实只是“路过式扫描”。
为什么 pytest --flake8 默认不失败？
因为 pytest-flake8 把 flake8 检查当作普通测试项处理，默认遵循 pytest 的“失败才中断”逻辑，而它把每个文件的 lint 结果转成一个 test_*.py::flake8 用例。只要没配置严格模式，即使有 E501（行太长）或 F401（未使用导入），用例状态仍是 passed。
- 根本原因：插件默认启用
--flake8-quiet行为，只输出 summary，不触发 pytest 的 failure 机制 - 验证方式：加
-v运行，你会看到类似test_utils.py::flake8 PASSED，哪怕文件里全是print()调试残留 - 真实需求不是“看报告”，而是“有错误就阻断 CI 或本地提交”
让 flake8 错误真正导致 pytest 失败
必须显式启用 --flake8-max-line-length 或 --flake8-ignore 等参数来激活严格模式，但更可靠的是用 --flake8 配合 --strict-markers + 自定义 marker。
- 在
pyproject.toml中写死规则（推荐）：
[tool.pytest.ini_options] addopts = [ "--flake8", "--strict-markers", ] flake8-max-line-length = 88 flake8-ignore = ["E203", "W503"]
- 或命令行强制失败（适合 CI 临时调试）：
pytest --flake8 --flake8-max-line-length=88 --exitfirst - 关键点：
--flake8-max-line-length这类参数一旦出现，插件就会将违反规则视为 test failure；空配置 = 宽松模式
和 pre-commit、单独 flake8 命令的区别在哪？
三者目标一致，但执行时机和集成粒度不同：pre-commit 是 Git hook 层拦截，flake8 . 是纯静态扫描，而 pytest --flake8 是把 lint 当作测试生命周期一部分——这意味着你能复用 pytest 的所有能力。
- 可以和其他测试共用
--tb=short、--disable-warnings等开关 - CI 中统一用
pytest -xvs --flake8即可同时跑单元测试和代码规范，不用拆成两个 job - 但注意：pytest-flake8 不支持 flake8 6.0+ 的部分新规则（如
ANN类型注解检查），遇到invalid option错误要降级 flake8 或换pylint补位
最常被忽略的是：pytest-flake8 不读取项目根目录下的 .flake8 或 setup.cfg，只认 pytest 配置段里的 flake8-* 选项。改完配置别忘了删 __pycache__/ 和 .pytest_cache/，否则旧行为可能缓存生效。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
