pytest官方文档解读fixtures的调用方式

清欢

发布时间：2026-10-16 | 5人浏览过

原创

本文深入解读pytest官方文档中关于fixtures的调用机制。详细说明了测试函数如何通过声明参数来请求fixture，以及pytest如何查找并执行对应的fixture函数。重点分析了fixture返回值如何作为参数传递给测试函数，并通过代码示例展示了从请求到执行的完整流程，帮助开发者理解fixture的复用性和调用逻辑。

pytest官方文档中关于fixtures的调用机制

既然fixture的主要作用是为测试执行做准备，那么pytest是如何确定哪些测试函数或fixture需要依赖特定的fixture呢？核心问题在于fixture的调用方式。

一、测试函数通过声明参数请求fixture

测试函数可以通过将fixture名称声明为函数参数，从而显式地请求该fixture。

def test_my_fruit_in_basket(my_fruit, fruit_basket):
    # 这是一个测试函数
    assert my_fruit in fruit_basket

参考前文示例，测试函数test_my_fruit_in_basket通过传入my_fruit和fruit_basket这两个参数，分别调用了对应的两个fixture。

当pytest执行测试函数时，它会检查该函数的参数列表，并在已注册的fixture中查找名称匹配的对象。一旦找到匹配的fixture，pytest就会自动执行这些fixture函数。

二、fixture返回值传递给测试函数

此外，如果fixture函数包含return语句返回了具体对象，pytest会捕获这些返回值，并将它们作为参数传递给请求该fixture的测试函数。具体示例如下：

class Fruit:
    def __init__(self, name):
        self.name = name
        self.cubed = False
    def cube(self):
        self.cubed = True
class FruitSalad:
    def __init__(self, *fruit_bowl):
        self.fruit = fruit_bowl
        self._cube_fruit()
    def _cube_fruit(self):
        for fruit in self.fruit:
            fruit.cube()
# Arrange
@pytest.fixture
def fruit_bowl():
    return [Fruit("apple"), Fruit("banana")]
def test_fruit_salad(fruit_bowl):
    # Act
    # 这里接收到fixture函数fruit_bowl的返回值，
    # 也就是[Fruit("apple"), Fruit("banana")]，并使用
    fruit_salad = FruitSalad(*fruit_bowl)
    # Assert
    # python内置函数all()，用于判断给定的可迭代参数 iterable 中的所有元素是否都为 TRUE，
    # 如果是返回 True，否则返回 False
    assert all(fruit.cubed for fruit in fruit_salad.fruit)

注：此处可以编写简单的代码进行说明，但为了加深理解，阅读稍复杂的代码示例并无坏处。

对于不熟悉Python的读者，官方示例可能显得晦涩。我们的重点不在于代码细节，而在于理清其中的传递关系：

首先，测试函数test_fruit_salad通过参数fruit_bowl请求了名为fruit_bowl的fixture（即def test_fruit_salad(fruit_bowl):）。
此时，pytest会执行fixture函数fruit_bowl，并将该函数的返回值作为fruit_bowl参数传递给测试函数test_fruit_salad。

这就是当某个fixture被请求调用时，pytest内部发生的具体过程。

如果上述fixture函数的执行逻辑由我们手动实现，大致流程如下：

# 上面的2个类不变
...
def fruit_bowl():
    return [Fruit("apple"), Fruit("banana")]
def test_fruit_salad(fruit_bowl):
    # Act
    fruit_salad = FruitSalad(*fruit_bowl)
    # Assert
    assert all(fruit.cubed for fruit in fruit_salad.fruit)
# Arrange
bowl = fruit_bowl()
test_fruit_salad(fruit_bowl=bowl)

相信通过上述解析，读者已经对fixture的调用过程有了清晰的认识。

如果仍觉得官方代码示例难以理解，这里提供一个简化版的示例供参考：

import pytest
# Arrange
@pytest.fixture
def fruit_bowl():
    return ["苹果", "香蕉"]
def test_fruit_salad(fruit_bowl):
    # Act
    fruit_salad = fruit_bowl[0] + fruit_bowl[1]
    # Assert
    assert fruit_salad == "苹果香蕉"

接下来，我们将继续依据官方文档，深入解读fixture的其他特性：包括fixture调用其他fixture以及fixture的复用性。

以上是对pytest官方文档中fixtures调用方式的详细解读，更多关于pytest官方文档fixtures调用的资料，请关注本站其他相关文章！