pytest -x（即--exitfirst）在首个测试失败或出错时立即终止执行，避免后续冗余运行，适用于本地调试、CI快速反馈及防止连锁错误；等价于--maxfail=1，但语义更明确且部分插件对其有特殊支持。
使用 --exitfirst 参数让 pytest 失败后立刻退出
pytest 默认会跑完所有用例再汇总结果，但调试时你往往只想看到第一个失败点。加 --exitfirst（可简写为 -x）就能做到：只要任意一个测试用例失败或出错，pytest 立即终止执行，不继续跑后续用例。
常见场景包括：本地快速验证修复是否生效、CI 中缩短失败反馈时间、避免因前置失败导致后续用例报一堆无意义的连锁错误。
-
pytest -x：最常用，简洁明确 -
pytest --exitfirst：语义更清晰，适合写进pyproject.toml或 CI 脚本 - 它对
setup_method、teardown_class等 fixture 也生效——失败发生在 setup 阶段，同样立即停 - 注意：它不会跳过已开始执行的测试函数，而是等当前用例结束（含 teardown）后退出，不是“中断执行”
--maxfail 和 --exitfirst 的区别在哪
--exitfirst 是“失败 1 次就停”，而 --maxfail=n 是“累计失败 n 次才停”。两者都控制退出时机，但适用逻辑不同。
-
pytest --maxfail=3：允许前两个失败，第三个失败时才退出；适合想批量收集几处典型问题的场景 -
pytest -x：等价于--maxfail=1，但语义更强，且部分插件（如pytest-xdist）对-x有特殊处理（比如在分布式模式下协调各 worker 提前退出） - 如果同时指定
-x和--maxfail=5，-x优先生效 - 在
pyproject.toml中配置时，推荐用完整名：[tool.pytest.ini_options] exitfirst = true
在 pytest.ini 或 pyproject.toml 中持久化设置
每次敲 -x 很麻烦，尤其团队协作时容易遗漏。直接写进配置文件最稳妥。
立即学习“Python免费学习笔记（深入）”；
- 旧式
pytest.ini：[pytest] addopts = -x
- 现代推荐
pyproject.toml：[tool.pytest.ini_options] addopts = ["-x"]
- 注意：
addopts是列表形式，不能写成字符串（"-x"会导致解析失败） - 如果项目中已有其他默认参数（如
--tb=short），把-x加进去即可，顺序无关 - 配置后，连
python -m pytest也会生效，无需改调用方式
和 --strict-markers 或 --strict-config 混用时要注意什么
这些选项本身不冲突，但它们触发的退出行为优先级高于 -x。比如：
- 遇到未注册的 marker（如用了
@pytest.mark.asyncio却没装pytest-asyncio），--strict-markers会直接报错退出，此时甚至不会走到“执行测试用例”阶段，-x就没机会起作用 - 同理，
pyproject.toml里写了非法配置项，且启用了--strict-config，pytest 会在加载配置时就失败退出 - 所以如果你希望“只在测试运行阶段失败才退出”，得确认没启用这些提前校验类开关，或者接受它们更高的优先级
-x 停下后 fixture 的 teardown 仍会执行——但如果 teardown 本身也失败，pytest 会把它记作“error”而非“failure”，而 -x 默认对 error 同样生效。这点在写 cleanup 逻辑时得格外小心。 
