pytest.mark.parametrize 必须写在测试函数上方，因为它是装饰器，在收集阶段生成多个测试实例；若位置错误则失效，仅运行1次且参数未注入。
pytest.mark.parametrize 为什么必须写在测试函数上方
因为 pytest.mark.parametrize 是装饰器，它在测试函数被收集（collection）阶段就生效，用于生成多个测试用例实例。如果写在函数内部或下方，Python 解析时根本不会识别为装饰行为，直接报 SyntaxError 或被忽略——测试只会跑 1 次，且参数未注入。
常见错误现象：测试函数名没变、控制台只显示 1 个用例、print(arg) 输出为空或报 NameError。
正确写法要点：
- 必须紧贴测试函数定义上方，中间不能有空行或注释（除非用
# type: ignore注释掉 lint 报错） - 第一个参数是字符串，多个参数名用逗号分隔，如
"x, y, expected"，不能写成元组或列表 - 第二个参数是可迭代对象，推荐用
list[tuple]，例如[(1, 2, 3), (2, 3, 5)]；避免传入生成器（会导致第二次遍历时为空）
数据里含字典或嵌套结构时怎么避免 pytest 报错
pytest 默认把每组参数转成字符串作为测试 ID，而字典、列表、自定义对象的 __repr__ 可能含空格、括号或特殊字符，导致 ID 不合法，最终报错 ValueError: invalid parameter name 或测试名显示异常（如 test_add[{'a': 1}] 被截断）。
立即学习“Python免费学习笔记（深入）”；
解决方法是显式提供 ids 参数：
@pytest.mark.parametrize(
"data,expected",
[
({"name": "alice", "age": 30}, True),
({"name": "bob", "age": -5}, False),
],
ids=["valid_user", "invalid_age"]
)
def test_validate_user(data, expected):
assert validate(data) == expected
注意：ids 列表长度必须和数据组数一致；若想自动生成简洁 ID，可用 lambda：ids=lambda x: f"case-{hash(str(x)) % 1000}"，但不推荐用于调试场景。
如何跳过某几组参数组合而不删数据
不是所有参数组合都需要运行，比如某些组合只在 CI 环境下才有效，或存在已知缺陷暂时绕过。这时别用 if 在函数内 return 或 pytest.skip() ——那会浪费收集和 setup 开销，且测试报告仍计为“已运行”。
应该用 pytest.param 显式标记跳过：
@pytest.mark.parametrize(
"host,port,timeout",
[
pytest.param("localhost", 8080, 1.0, id="local-fast"),
pytest.param("api.example.com", 443, 30.0, marks=pytest.mark.skip(reason="flaky in CI")),
pytest.param("staging.example.com", 443, 10.0, marks=pytest.mark.xfail(reason="auth bug pending fix")),
]
)
def test_connect(host, port, timeout):
assert connect(host, port, timeout) is not None
关键点：
-
pytest.param(..., marks=...)中的marks必须是单个 mark 对象或元组，不能传字符串 -
@pytest.mark.skip和@pytest.mark.xfail行为不同：前者不执行，后者执行但失败也不算红条 - 所有
pytest.param必须和其他普通元组混在同一列表中，不能单独再套一层[]
fixture 和 parametrize 一起用时谁先执行
fixture 总是先于 parametrize 的参数注入执行。也就是说，如果你写了 @pytest.mark.parametrize("x", [1, 2]) 并同时用了 @pytest.fixture，那么 fixture 会被调用 2 次（每次对应一组参数），而不是只调用 1 次后复用结果。
容易踩的坑：
- 数据库 fixture 如果是
scope="function"，每组参数都会新建连接+清库，性能差；应改用scope="class"或手动缓存 - 不要在 fixture 里读取
parametrize的参数值（比如想根据x动态返回不同 mock），因为 fixture 运行时参数还没注入——此时x是未定义的 - 若需参数化 fixture 本身，要用
params参数配合request.param，而不是混用mark.parametrize
真正复杂的参数组合逻辑（比如笛卡尔积、条件过滤、环境感知）建议提前在 conftest.py 里用 Python 构造好数据列表，而不是硬塞在测试函数上方——否则可读性迅速崩坏，改一行要 grep 十个文件。
