如何使用pytest-xdist并行执行pytest测试套件且保持各套件内测试用例顺序

没问题，这其实是pytest-xdist的常见需求，你可以通过调整它的任务分发模式轻松实现目标，下面是两个可行方案：

方案1：使用--dist=loadfile参数（最直接高效） #

pytest-xdist默认的分发模式是loadscope，它会按测试模块或类拆分任务，可能导致单个文件内的用例被分到不同worker，打乱原有顺序。而loadfile模式会把整个测试文件作为一个完整单元分配给单个worker，这样每个worker会按文件内的原始顺序执行所有用例，同时多个文件可以并行运行。

只需要修改你的执行命令：

pytest test_one.py test_two.py -n 2 --dist=loadfile

这个命令会让两个worker各自负责一个测试文件，test_one.py和test_two.py内的用例都会严格按照你编写的顺序执行，且两个文件的执行过程是并行的。

方案2：自定义测试分组（应对复杂场景） #

如果你的需求更复杂（比如要把多个文件当成一个逻辑套件整体执行），可以通过pytest的钩子函数自定义分组规则。在项目根目录创建conftest.py文件，添加以下代码：

def pytest_collection_modifyitems(config, items):
    # 按测试文件路径对用例分组
    file_groups = {}
    for item in items:
        file_path = item.fspath.strpath
        if file_path not in file_groups:
            file_groups[file_path] = []
        file_groups[file_path].append(item)
    
    # 重置用例列表，按组添加以保持组内顺序
    items[:] = []
    for group in file_groups.values():
        items.extend(group)

然后搭配--dist=loadgroup参数执行命令：

pytest test_one.py test_two.py -n 2 --dist=loadgroup

这个方案会将同一文件的所有用例归为一个分组，worker会完整执行整个分组，从而严格保持组内用例的原始顺序。

额外注意 #

• 确保你的pytest和pytest-xdist是最新版本，旧版本可能对loadfile或loadgroup模式支持不完善；
• 虽然方案能解决顺序问题，但如果测试用例依赖前置用例的执行结果，这种设计其实并不推荐，最好还是让每个用例保持独立性——当然如果是业务场景必须要求顺序，上面的方案完全可以满足需求。

内容的提问来源于stack exchange，提问作者user17034571