pytest中@pytest.mark.parametrize()参数化用法详解与示例

阿麦

发布时间：2026-10-15| 4人浏览过

原创

本文详细介绍pytest框架中@pytest.mark.parametrize()装饰器的核心用法。通过单参数多值、多参数组合、字典数据传入等实例，展示如何实现测试用例的参数化，提升测试覆盖率与代码复用性。

1. 方法详情：

parametrize(argnames, argvalues, indirect=False, ids=None, scope=None) 是 pytest 中用于参数化的核心装饰器。其常用参数包括： - argnames：指定测试函数的参数名称。 - argvalues：定义参数值，支持列表、元组或字典等格式。若参数值包含 N 个元素，则对应的测试用例将执行 N 次。

2. 使用方法

2.1. 一个列表中一个参数多个值

示例代码：

data_list1 = ['data1', 'data2', 'data3', 'data4']
@pytest.mark.parametrize('data', data_list1)
def test_01(data):
    print(data)

运行结果：

2.2. 多参数多值

示例代码：

data_list2 = [('zhang1', '123456'), ('zhang2', '654321'), ('zhang3', '456789')]
@pytest.mark.parametrize('username, pwd', data_list2)
def test_02(username, pwd):
    print(username + ':' + pwd)

运行结果：

2.3. 多个参数混合使用

示例代码：

data_list3 = ['zhang', 'li']
data_list4 = ['wang', 'liu']
data_list5 = ['zhao', 'qian']
@pytest.mark.parametrize('a', data_list3)
@pytest.mark.parametrize('b', data_list4)
@pytest.mark.parametrize('c', data_list5)
def test_03(a, b, c):
    print('组合后的结果为', {a}, {b}, {c})

2.4. 传入字典数据

示例代码：

dict_data = ({'username': 'zhang', 'password': '123456'}, {'username': 'li', 'password': '654321'})
@pytest.mark.parametrize('data', dict_data)
def test_04(data):
    print(data.get('username') + ':' + data.get('password'))
    # print(data['username'] + ':' + data['password'])

运行结果：