### Python 中 `@pytest.mark.parametrize` 的使用方法与示例 #### 参数化的概念 参数化是指在编写单元测试时，通过传递一组或多组输入数据及其预期输出到同一个测试函数中，从而实现多次执行该测试的功能。这种方式能够显著减少重复代码量，并使测试更加灵活高效[^1]。 #### 基本语法结构 ```python @pytest.mark.parametrize('参数名', [值列表]) def test_名称(参数名): 断言语句... ``` - **单个参数的情况** 当只需要改变单一变量时，可以直接指定它的名字和对应的取值集合即可完成配置工作。 - **多个参数的情况** 对于涉及两个及以上独立维度的变化情况，则需分别列举各自可能的选项并通过笛卡尔乘积的形式生成全部组合情形下的测试案例[^2]。 #### 组合不同参数化维度 如果希望同时考虑几个方面的变动因素作用下程序的行为特点，那么可以叠加使用多个`@pytest.mark.parametrize()`装饰器来达到目的。例如下面的例子演示了两层嵌套式的参数扩展方式： ```python import pytest @pytest.mark.parametrize('x', [1, 2]) @pytest.mark.parametrize('y', [3, 4]) def test_parametrize_combination(x, y): print(f"x={x}, y={y}") # Add your assertions here based on the logic you want to verify. ``` 在这个例子当中，总共会有四个不同的 `(x,y)` 配对被用来调用这个测试函数——即 (1,3),(1,4),(2,3) 和 (2,4)。 #### 处理特殊状态 - XFail & Skip 有时候我们可能会遇到某些条件下应该失败或者是暂时不需要关注的情形，在这些时候就可以借助 PyTest 提供的相关标志位来进行特别标注处理而不至于让整个构建流水线因为个别特殊情况而出错中断进程。如下所示： ```python import pytest @pytest.mark.parametrize( "test_input,expected", [ ("3+5", 8), ("2+4", 6), pytest.param("6*9", 42, marks=pytest.mark.xfail(reason="known parser issue")), pytest.param("6*6", 36, marks=pytest.mark.skip(reason="not implemented yet")) ] ) def test_evaluate_expression(test_input, expected): assert eval(test_input) == expected ``` 这里定义了一个表达式求值的小型计算器样例测试集，其中包含了正常工作的加法运算以及存在问题的乘法规则违反项还有待开发的新特性预留位置等多元化场景覆盖。 #### 动态获取测试数据源 除了硬编码固定数值之外，也可以从外部文件读入动态更新的数据作为测试依据之一。另外还有一种比较有趣的技巧就是结合 Fixtures 来间接传参给 Parametrized Tests 。就像这样: ```python import pytest @pytest.fixture(params=["apple", "banana"]) def fruit(request): return request.param @pytest.mark.parametrize("color", ["red", "yellow"]) def test_fruits(color, fruit): print(f"The color of {fruit} is usually {color}.") # Implement actual checks according to application's business rules. ``` 或者更进一步地利用 lazy fixtures : ```python import pytest @pytest.fixture(params=[1, 2]) def number(request): return request.param @pytest.mark.parametrize('operation,result', [('addition', lambda n: n + 1)]) def test_lazy(operation, result, number): operation_result = result(number) print(f"{number} after '{operation}' becomes {operation_result}.") # Insert relevant validation steps depending upon system under testing. ``` 以上两种写法均体现了灵活性强的优势所在[^3]。 ---