pytest 常见问题解答 (FAQ)

1. 基础问题

Q1: 如何让 pytest 发现我的测试文件？

测试文件命名需符合 test_*.py 或 *_test.py 模式
测试函数/方法需以 test_ 开头
测试类需以 Test 开头(且不能有__init__方法)

Q2: 如何运行特定测试？

bash 复制代码

pytest path/to/test_file.py::test_func  # 运行单个测试
pytest -k "pattern"                     # 运行名称匹配的测试
pytest -m mark_name                     # 运行特定标记的测试

Q3: 如何查看详细的测试输出？

bash 复制代码

pytest -v      # 详细模式
pytest -s      # 显示print输出
pytest --tb=auto  # 控制错误回溯显示方式(native/short/no等)

2. 配置问题

Q4: 如何配置 pytest 默认选项？

在项目根目录创建 pytest.ini:

ini 复制代码

[pytest]
addopts = -v --tb=short
python_files = test_*.py
markers =
    slow: marks tests as slow

Q5: 如何跳过某些测试？

python 复制代码

@pytest.mark.skip(reason="Not implemented yet")
def test_feature():
    ...

@pytest.mark.skipif(sys.version_info < (3, 8), reason="requires Python 3.8+")
def test_py38_feature():
    ...

3. 高级用法问题

Q6: 什么是 fixture？如何使用？

Fixture 是 pytest 的依赖注入系统：

python 复制代码

@pytest.fixture
def db_connection():
    conn = create_connection()
    yield conn  # 测试执行前运行
    conn.close()  # 测试执行后清理

def test_query(db_connection):  # 自动注入fixture
    result = db_connection.query("SELECT 1")
    assert result == 1

Q7: 如何参数化测试？

python 复制代码

@pytest.mark.parametrize("input,expected", [
    ("3+5", 8),
    ("2+4", 6),
])
def test_eval(input, expected):
    assert eval(input) == expected

4. 常见错误解决

Q8: 遇到 "fixture not found" 错误？

确保 fixture 名称拼写正确
将常用 fixture 放在 conftest.py 文件中
检查 fixture 作用域(如 module/session 级fixture不能用在函数级fixture中)

Q9: 如何解决插件冲突？

bash 复制代码

pip list | grep pytest  # 查看已安装插件
pytest --trace-config  # 查看加载的插件

5. 集成与扩展

Q10: 如何生成覆盖率报告？

bash 复制代码

pip install pytest-cov
pytest --cov=my_package --cov-report=html

Q11: 如何并行运行测试？

bash 复制代码

pip install pytest-xdist
pytest -n 4  # 使用4个worker

6. 调试技巧

Q12: 如何调试失败的测试？

bash 复制代码

pytest --pdb  # 失败时进入pdb调试
pytest --trace  # 立即进入调试在每个测试开始前

Q13: 如何查看fixture执行顺序？

bash 复制代码

pytest --setup-show test_file.py

7. 最佳实践

Q14: 如何组织大型测试套件？

按功能模块组织测试文件
使用 conftest.py 共享 fixture
合理使用标记分类测试

Q15: 如何测试异常？

python 复制代码

def test_divide_by_zero():
    with pytest.raises(ZeroDivisionError):
        1 / 0
    # 也可以检查异常信息
    with pytest.raises(ValueError, match="invalid literal"):
        int("a")

8. 性能问题

Q16: 如何加速测试执行？

使用 pytest-xdist 并行运行
减少 I/O 操作，使用 mock
将慢测试标记为 @pytest.mark.slow 并默认跳过