如何在Python的Pytest中用Given-When-Then编写行为单元测试？求实战方案

一、是否推荐用Pytest Fixtures实现？ #

绝对推荐。Fixtures是Pytest的核心特性，天生适配Given-When-Then的测试结构，能清晰分离测试准备、执行、断言三个阶段，既提升测试可读性，又能复用重复逻辑，完美契合你延续Pytest框架的需求。

1. 文档字符串+Fixtures的结构化写法 #

你搜到的用文档字符串描述GIVEN-WHEN-THEN的方式完全可行，搭配Fixtures实现前置准备，能让测试逻辑既规范又直观：

import pytest

@pytest.fixture
def phone_book_with_records():
    # GIVEN：准备带记录的PhoneBook实例
    phone_book = PhoneBook()
    phone_book.add("Alice", "12345")
    phone_book.add("Bob", "67890")
    return phone_book

def test_phone_book_all_returns_sorted_records(phone_book_with_records):
    """
    GIVEN 一个包含多条记录的PhoneBook实例
    WHEN 调用all()方法
    THEN 返回的号码列表按升序排列
    """
    # WHEN：执行测试动作
    result = phone_book_with_records.all()
    # THEN：断言结果
    assert result == ["12345", "67890"]

2. 模仿C#风格的函数式写法 #

如果你习惯C#那种用独立函数封装各阶段的模式，在Pytest里可以直接照搬，完全贴合你的使用习惯：

def given_an_authenticated_user():
    # GIVEN：构建认证用户
    user = User(id=1, is_authenticated=True)
    return user

def when_i_reconcile_a_transaction(user, transaction):
    # WHEN：执行对账操作
    transaction_service = TransactionService()
    return transaction_service.reconcile(user, transaction)

def then_transaction_status_is_reconciled(transaction_result):
    # THEN：断言状态
    return transaction_result.status == "RECONCILED"

def test_transaction_reconciliation():
    # 组装GIVEN-WHEN-THEN流程
    authed_user = given_an_authenticated_user()
    test_transaction = Transaction(id=100, status="PENDING")
    
    transaction_result = when_i_reconcile_a_transaction(authed_user, test_transaction)
    
    assert then_transaction_status_is_reconciled(transaction_result)

二、实战优化指导 #

• 复用Fixtures：把重复的前置逻辑（比如创建认证用户、初始化测试数据库）做成可复用的Fixtures，跨测试用例共享，减少冗余代码。
• 保持单一职责：每个测试用例只对应一个场景，避免一个测试里嵌套多个WHEN-THEN分支，确保测试失败时能快速定位问题。
• 结合参数化：用@pytest.mark.parametrize批量测试不同输入场景，比如测试不同状态的交易对账结果，高效提升测试覆盖率。
• 避免过度封装：如果断言逻辑简单，直接在测试里写assert即可，不用强行封装成then_*函数，保持代码简洁。

三、额外实战案例：API接口测试 #

import pytest
import requests

@pytest.fixture
def given_authenticated_api_client():
    # GIVEN：准备已认证的API客户端配置
    return {
        "base_url": "http://test-api.com",
        "headers": {"Authorization": "Bearer test-token"}
    }

def test_user_profile_retrieval(given_authenticated_api_client):
    """
    GIVEN 已认证的API客户端
    WHEN 发送GET请求获取用户信息
    THEN 返回200状态码，且用户信息匹配预期
    """
    # WHEN：执行接口请求
    response = requests.get(
        f"{given_authenticated_api_client['base_url']}/users/1",
        headers=given_authenticated_api_client["headers"]
    )
    # THEN：断言结果
    assert response.status_code == 200
    assert response.json()["id"] == 1
    assert response.json()["name"] == "Test User"

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