pytest重复执行用例：pytest-repeat插件使用方法

pytest-repeat插件为Python测试提供了轻量、灵活且高度契合pytest设计哲学的用例重复执行方案，无需修改测试逻辑或手动编写循环，仅通过命令行参数（如--count）、装饰器（@pytest.mark.repeat）和作用域控制（--repeat-scope）即可精准实现函数级、类级、模块级乃至会话级的重复策略；它支持与pytest-xdist、--lf等常用插件协同工作，但需注意行为叠加细节，同时以直观的逐次执行反馈（如✓✓✓✓✓）和严格的生命周期管理（如setup/teardown按作用域正确触发）确保重复结果的可靠性和可调试性——是应对不稳定测试、网络波动或偶发故障最实用、最易上手的官方风格解决方案。

直接用 pytest-repeat 插件是最轻量、最符合 pytest 哲学的方案，不用改测试逻辑，也不用自己写循环或参数化包装。

安装和基础命令行用法

插件必须显式安装，pytest 默认不带重复执行能力。注意包名是 pytest-repeat，不是 pytest-repeat 或 pytest_repeat —— 拼错就报 ModuleNotFoundError: No module named 'pytest_repeat'。

• 安装命令： pip install pytest-repeat（Python 3.5+，pytest 3.6+）
• 运行单个文件所有用例 5 次： pytest --count=5 test_example.py
• 只对某几个用例生效： pytest --count=3 -k "test_login or test_logout" test_api.py

执行后你会看到进度条逐次递增（比如 ✓✓✓✓✓），而不是一次性跑完再汇总——这是它按「每个用例独立重复」执行的视觉反馈，不是 bug。

@pytest.mark.repeat(count) 装饰器怎么用

适合只想让某个不稳定用例多跑几次，又不想影响其他用例。装饰器优先级高于命令行 --count，即两者都存在时，以装饰器指定的次数为准。

• 基本写法：@pytest.mark.repeat(5) 必须紧贴函数定义上方，不能漏掉括号
• 不支持传变量：@pytest.mark.repeat(n) 会报错，n 必须是字面量整数
• 可叠加其他标记，比如：@pytest.mark.repeat(3) + @pytest.mark.flaky(reruns=2) 是合法的，但要注意行为叠加顺序（先 repeat 再 rerun）

示例：

import pytest

@pytest.mark.repeat(4)
def test_network_timeout():
    assert call_api(timeout=0.1) == "timeout"

执行 pytest -s test_network.py 就会打印 4 次结果，每次都是独立的 setup/teardown 生命周期。

--repeat-scope 控制重复粒度

默认是 function 级别：每个用例单独重复 N 次，再跑下一个。但有时你需要“整个 class 一起重复”或“模块内所有用例轮着跑完再重来”，就得靠这个参数。

• --repeat-scope=function：默认值，最常用；每个 def test_* 执行 N 次
• --repeat-scope=class：一个 class TestFoo: 里所有用例执行一遍 → 再执行一遍 → … 共 N 轮
• --repeat-scope=module：整个 .py 文件所有用例跑完一轮 → 再跑一轮 → 共 N 轮
• --repeat-scope=session：所有匹配的用例（含多个文件）先全跑一遍 → 再全跑一遍 → 共 N 轮

注意：session 模式下如果用了 pytest-xdist 并行，重复逻辑仍由主进程协调，不会出现“worker 自己重复”，但报告合并可能变复杂。

和 pytest-xdist、--lf、--ff 这些选项混用要注意什么

它们能共存，但行为不是直觉上的“叠加”。比如：

• pytest --count=5 --lf：只对上次失败的用例重复 5 次，不是“上次失败的用例 + 本次新增的用例”各跑 5 次
• pytest --count=3 -x：遇到第一次失败就中断，总共最多跑 3 次中的前几次，不是强制跑满 3 次
• pytest --count=2 -n 2：两个 worker 各自负责一部分用例，每个被分配到的用例仍重复 2 次——总执行次数 = （分配到的用例数）× 2，不是全局统一计数

最容易被忽略的是：setup_class/teardown_class 在 --repeat-scope=class 下每轮都会触发一次；但如果你用的是默认 function 模式，它们只在第一轮执行——这点不看文档很容易误以为 fixture 失效了。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《pytest重复执行用例：pytest-repeat插件使用方法》文章吧，也可关注golang学习网公众号了解相关技术文章。