pytest-repeat插件提供最轻量、符合pytest哲学的重复执行方案，支持命令行--count、装饰器@pytest.mark.repeat及--repeat-scope控制粒度，安装命令为pip install pytest-repeat。
直接用 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 失效了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
