pytest.mark.parametrize需确保每组参数触发独立代码分支，参数名须与形参严格一致，依赖参数用ids人工标注，fixture作用域需降为function避免脏状态，复杂类型用json序列化+手动ids，启用--cov-branch检测未覆盖分支。
pytest.mark.parametrize 怎么写才不漏用例
参数化测试不是把数据塞进装饰器就完事，漏掉组合、错用嵌套或忽略边界值，覆盖率反而会虚高。核心是让每组输入真正触发不同分支逻辑。
- 别用
itertools.product自动生成所有组合后硬塞进@pytest.mark.parametrize—— 容易生成大量无效用例（比如None和空字符串同时传给一个只校验非空的函数） - 每个参数名必须和函数签名里的形参名严格一致，大小写、下划线都不能错，否则报
TypeError: test_xxx() got an unexpected keyword argument - 如果参数之间有依赖（比如
user_role决定expected_status），优先用ids参数人工标注用例含义，而不是靠顺序脑补
示例：正确标注依赖关系
@pytest.mark.parametrize(
"user_role,expected_status",
[
("admin", 200),
("guest", 403),
("banned", 401),
],
ids=["admin_access", "guest_denied", "banned_blocked"]
)
def test_api_permission(user_role, expected_status):
...
fixture + parametrize 混用时作用域容易崩
fixture 声明了 scope="session" 或 scope="module"，但又被 @pytest.mark.parametrize 驱动多次执行，结果 fixture 只初始化一次，后续用例拿到的是脏状态。
- 只要 fixture 被参数化用例调用，它自己的 scope 就得降级到
"function"，否则状态复用会导致断言失败且难以复现 - 数据库连接、临时文件路径这类带副作用的 fixture，绝不能和参数化共用高阶 scope
- 如果真要共享 setup 开销，改用
pytest_generate_tests钩子，在收集阶段动态生成用例，绕过 fixture 生命周期干扰
参数化后覆盖率统计失真怎么办
pytest-cov 默认按源码行统计，但参数化用例实际只执行部分分支，报告却显示“整行已覆盖”，掩盖真实缺口。
立即学习“Python免费学习笔记（深入）”；
- 加
--cov-fail-under=95不解决问题，得配合--cov-branch开启分支覆盖，才能发现if/else里某个分支根本没被任何参数触发 - 用
pytest --collect-only先看实际生成了多少个用例，和你预想的组合数对不上？说明parametrize数据结构有误（比如传了字典但没解包） - 避免在测试函数里用
if分支处理不同参数 —— 这会让覆盖率工具误判“该行已执行”，正确做法是拆成多个独立参数化用例，或用pytest.skipif显式跳过不适用场景
复杂类型参数（如嵌套 dict/list）怎么传才不报错
直接往 @pytest.mark.parametrize 里扔大字典，pytest 会尝试序列化它生成用例 ID，遇到不可哈希或含函数的对象就崩： TypeError: unhashable type: 'dict'。
- 永远用
ids手动指定字符串 ID，哪怕只是编号ids=["case_1", "case_2"]，彻底绕过自动 ID 生成 - 嵌套结构先转成 JSON 字符串再传入，测试函数里再
json.loads，比传原生 dict 更稳定 - 如果参数含可调用对象（比如 mock 方法），别传进去 —— 改用 fixture 封装行为，参数只传控制信号（如
"should_raise"）
参数化不是堆数据，是精准打点。最容易被忽略的是：你写的每组参数，是否真的对应一段未被其他用例触达的代码路径。没验证这点，覆盖率数字就是幻觉。
