pytest conftest.py使用的小结

更新时间：2025年10月31日 11:54:11 作者：一半烟火以谋生

pytest的conftest.py是核心配置文件, 本文就来详细介绍pytest conftest.py使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

1. conftest.py 是什么？

核心配置文件，用于存放测试用例的共享逻辑
自动被 pytest 发现，无需显式导入
支持功能：夹具(fixture)、钩子函数(hooks)、插件配置

2. 基础环境搭建

安装 pytest：
```
pip install pytest
```

创建项目结构：

project/
├── tests/
│   ├── conftest.py    # 核心配置文件
│   ├── test_api.py    # 测试用例1
│   └── test_db.py     # 测试用例2

3. 夹具(fixture)实战

场景：多个测试用例共享数据库连接
在 conftest.py 中添加：

import pytest
import psycopg2

@pytest.fixture(scope="module")
def db_connection():
    """创建数据库连接（模块级共享）"""
    conn = psycopg2.connect("dbname=test user=postgres")
    yield conn  # 测试执行时返回连接
    conn.close()  # 测试结束后自动关闭

在测试用例中使用（test_db.py）：

def test_user_count(db_connection):
    cursor = db_connection.cursor()
    cursor.execute("SELECT COUNT(*) FROM users")
    assert cursor.fetchone()[0] > 0

4. 钩子函数(hooks)应用

场景：自定义测试报告头信息
在 conftest.py 中添加：

def pytest_report_header(config):
    """在报告中显示自定义环境信息"""
    return "测试环境: Production v2.1 | 执行人: ${USER}"

运行测试时将显示：

============================ test session starts ============================
测试环境: Production v2.1 | 执行人: alice

5. 作用域控制

层级	说明	示例路径
目录级	影响当前目录及子目录	`/tests/conftest.py`
多级嵌套	支持不同目录的独立配置	`/tests/api/conftest.py`
全局	项目根目录的配置全局生效	`/conftest.py`

优先级规则：

子目录 > 父目录
就近原则

6. 高级技巧：参数化夹具

场景：测试不同浏览器的兼容性
在 conftest.py 中添加：

import pytest

@pytest.fixture(params=["chrome", "firefox", "edge"])
def browser(request):
    """参数化浏览器驱动"""
    driver = setup_browser(request.param)
    yield driver
    driver.quit()

测试用例自动运行3次：

def test_login(browser):
    browser.get("https://example.com/login")
    # 断言登录页面标题
    assert "Login" in browser.title

7. 最佳实践

避免过度使用：仅在需要共享逻辑时使用
命名规范：夹具名称应具有描述性（如 db_connection）
作用域选择：
- function（默认）：每个测试函数执行一次
- class：每个测试类执行一次
- module：每个模块执行一次
- session：整个测试会话执行一次

调试技巧：查看夹具生效情况

pytest --fixtures  # 显示所有可用夹具

8. 完整示例

项目结构：

project/
├── conftest.py                 # 全局配置
├── tests/
│   ├── conftest.py             # 测试目录配置
│   ├── test_api.py
│   └── web/
│       ├── conftest.py         # 子目录专属配置
│       └── test_ui.py

层级配置生效顺序：

web/conftest.py
tests/conftest.py
根目录 conftest.py

通过合理使用 conftest.py，可将测试代码复用率提升 60%+，同时保持测试逻辑的清晰隔离。

到此这篇关于pytest conftest.py使用的小结的文章就介绍到这了,更多相关pytest conftest.py使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Python matplotlib实战之箱型图绘制
箱型图（Box Plot）,也称为盒须图或盒式图,是一种用作显示一组数据分布情况的统计图,因型状如箱子而得名,本文主要为大家介绍了如何使用Matplotlib绘制箱型图,需要的小伙伴可以参考下
2023-08-08
python 解压、复制、删除文件的实例代码
这篇文章主要介绍了python 解压、复制、删除文件的实例代码,代码简单易懂非常不错，具有一定的参考借鉴价值，需要的朋友可以参考下
2020-02-02
Python: 传递列表副本方式
今天小编就为大家分享一篇Python: 传递列表副本方式，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2019-12-12
python协程库asyncio(异步io)问题
这篇文章主要介绍了python协程库asyncio(异步io)问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2023-11-11
Python爬虫requests模块之URL地址中的参数解读
这篇文章主要介绍了Python爬虫requests模块之URL地址中的参数解读,在你拿到数据所在的url地址之后，发送网络请求时，请求的url中包含两种地址参数:查询参数和请求参数,需要的朋友可以参考下
2023-08-08
Anaconda安装卸载的详细流程指南
本文介绍了Windows、macOS、Linux三大平台下Anaconda的安装与卸载指南,内容包括系统要求、版本选择、各平台安装步骤、安装后验证与配置、完整卸载流程及常见问题解决方案等,需要的朋友可以参考下
2026-04-04
详解python-nmap的安装与常用方法
python-nmap是一个基于Python的nmap网络扫描器接口,它允许用户通过 Python 脚本轻松地调用 nmap 的功能,nmap是一款功能强大的网络扫描和发现工具,本文给大家介绍python-nmap的安装与常用方法,需要的朋友可以参考下
2024-12-12
python各类经纬度转换的实例代码
这篇文章主要介绍了python各类经纬度转换的实例代码，非常不错，具有一定的参考借鉴价值，具有一定的参考借鉴价值,需要的朋友可以参考下
2019-08-08
python制作罗盘时钟效果
这篇文章主要介绍了python制作罗盘时钟效果,本文通过实例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
2024-04-04
苹果Macbook Pro13 M1芯片安装Pillow的方法步骤
Pillow作为python的第三方图像处理库,提供了广泛的文件格式支持，本文主要介绍了苹果Macbook Pro13 M1芯片安装Pillow，具有一定的参考价值，感兴趣的可以了解一下
2021-11-11