在编写自动化测试时，你是否遇到过这种“闹心”事：一个测试用例里需要校验 10 项数据，结果 第 1 项校验失败，整个用例就直接报错跳出了。剩下的 9 项到底对不对？不知道，得改完第一个再测。
以前我们要么忍受这种低效，要么写一堆复杂的 @pytest.mark.parametrize。但现在，Pytest 9.0+ 已经原生内置了 subtests 功能！它能让你在一个用例里跑多个“子测试”，互不干扰。
1. 什么是 Subtests？
subtests 是一种逻辑上的“用例分组”。它允许你在一个测试函数内部，运行多个独立的断言块。
核心特性：
- 独立执行：某个子测试失败，后续的子测试依然会继续执行。
- 聚合报告：在一个测试用例下汇总所有失败点。
- 动态生成：支持在循环或逻辑分支中动态创建，比参数化更灵活。
2. 使用示例
使用 subtests 无需安装额外插件（Pytest 9.0+），直接在函数参数中引入同名 fixture 即可。
基础代码示例
假设我们要测试一个接口返回的多个字段，不希望因为 name 错了就导致没测 age。
import pytest def test_user_data_logic(subtests): user_info = { "name": "hogwarts", "age": 18, "email": "invalid-email", # 假设这是个错误数据 "status": "active" } for key, value in user_info.items(): # 使用 with 语句开启子测试 # msg: 自定义描述信息；后面可以跟任意数量的关键字参数（如 field=key）用于标识数据 with subtests.test(msg=f"校验字段: {key}", field=key): if key == "email": assert"@"in value elif key == "age": assert value >= 18 else: assert value isnotNone
运行效果展示
当你运行上面的代码，你会看到类似下方的输出：
__________________ test_user_data_logic [校验字段: email] __________________ subtests = <_pytest.subtests.Subtests object at 0x...> def test_user_data_logic(subtests): ... > assert "@" in value E AssertionError: assert '@' in 'invalid-email' __________________________ test_user_data_logic ___________________________ contains 1 failed subtest ========================= short test summary info ========================= FAILED test_demo.py::test_user_data_logic - contains 1 failed subtest
即使 email 校验失败了，status 的校验依然被执行了,报告会清晰地告诉你哪个子测试（msg 或 field）出了问题。
4. 深度对比：Subtests vs 参数化
很多小伙伴会纠结：我用 @pytest.mark.parametrize 不也能达到类似效果吗？
| 维度 | 参数化 (Parametrize) | 子测试 (Subtests) |
| 定义时机 | 测试采集阶段（运行前确定） | 测试执行阶段（运行时动态决定） |
| 独立性 | 视为多个完全独立的用例 | 视为一个用例里的多个环节 |
| 性能/Setup | 每个参数重新触发 setup/teardown | 共享同一个 setup/teardown（更省资源） |
| 控制力 | 可通过命令行 -k 筛选单个参数运行 | 只能整体运行，无法单独筛选子项 |
5. 进阶技巧
A. 控制详细输出
默认情况下，Pytest 只显示失败的子测试。如果你想在控制台看到所有（包括成功）的子测试进度，请使用 -v 参数：pytest -v test_demo.py
B. 类型提示 (Typing)
如果你追求代码规范，可以为 subtests 加上类型注解，方便 IDE 进行补全：
import pytest def test_with_typing(subtests: pytest.Subtests): with subtests.test(): assert True
C. 旧版本兼容
如果你还在用 Pytest 8.x 或更早的版本，只需要手动安装插件即可拥有同样功能：pip install pytest-subtests
6. 避坑指南 & 最佳实践
- 不要滥用：不要把整个系统的测试都塞进一个函数里。Subtests 应该用于校验同一逻辑实体的不同属性。
- 异常处理：如果代码在
with subtests.test():块之外抛出了异常（比如数据库连接失败），测试依然会立刻终止。 - 数据隔离：由于所有子测试共享同一个测试函数的作用域，注意不要让上一个子测试修改了下一个子测试要用的变量。
结语
subtests 的引入补全了 Pytest 在“细粒度断言”上的短板。它既保留了单个用例的简洁，又提供了多点校验的韧性。
你觉得这个功能好用吗？或者在实际项目中遇到了哪些坑？欢迎在评论区交流讨论！ 🚀
