--maxfail=n 控制测试运行中累计失败用例数达n时立即中止，仅统计显式失败（failed），不包含error、skipped等；需写为--maxfail=n（n为正整数），配置文件中须通过addopts指定，且命令行参数优先级更高。
pytest --maxfail 参数到底能控制什么？
--maxfail 的作用很直接：当测试运行过程中累计失败的用例数达到指定值时，pytest 立即中止执行，不再运行后续用例。它只统计 显式失败（failed） 的测试，不包括错误（error）、跳过（skipped）或断言未触发的异常（比如 KeyboardInterrupt 或 SystemExit）。它也不影响 fixture 执行逻辑——即使某个 test 失败了，它的 teardown 仍会照常运行。
怎么正确传参？常见写法和典型错误
命令行中必须写成 --maxfail=N（等号不能省），N 是正整数。以下写法都无效：
-
pytest --maxfail N（缺等号 → 被当作另一个参数，--maxfail实际没生效） -
pytest --maxfail=0（N=0 会被忽略，相当于没设） -
pytest --maxfail=-1（负数不被接受，报错invalid int value）
正确示例：pytest --maxfail=3 表示第 3 个失败用例出现后立刻停；pytest --maxfail=1 是最常用调试模式，适合快速定位首个问题。
和 pytest.ini / pyproject.toml 配置混用时要注意什么？
如果在配置文件里也写了 --maxfail，命令行参数优先级更高。但要注意：pyproject.toml 中必须用 addopts，且等号写法要严格：
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
[tool.pytest.ini_options] addopts = ["--maxfail=2", "-v"]
别写成 maxfail = 2 —— 这种写法不会被识别，pytest 只认 addopts 里的完整参数字符串。另外，--maxfail 不支持在 conftest.py 里通过 pytest_addoption 动态覆盖，它属于启动阶段就解析的“硬开关”。
它对并发（-n）和子进程（--forked）的影响
在 -n（pytest-xdist）下，--maxfail 仍然有效，但行为略有不同：每个 worker 进程独立计数，主进程汇总后判断是否达到总数。这意味着你可能看到“第 3 个失败”出现在不同 worker 上，最终仍会中止。而 --forked 模式下，每个测试在独立子进程中运行，--maxfail 统计的是主进程收到的失败信号总数，不受 fork 内部异常干扰。不过，如果某个 fork 进程崩溃（比如 segfault），它可能被算作 error 而非 failed，就不会触发 --maxfail。
真正容易被忽略的是：它不阻断正在运行的测试——比如你设了 --maxfail=1，但当前正在跑一个耗时 10 秒的测试，它还是会跑完才退出。想中断长测试，得配合 --timeout 或信号机制。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
