pytest conftest.py使用的小結

更新時間：2025年10月31日 11:54:11 作者：一半煙火以謀生

pytest的conftest.py是核心配置文件, 本文就來詳細介紹pytest conftest.py使用,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

1. conftest.py 是什么？

核心配置文件，用于存放測試用例的共享邏輯
自動被 pytest 發(fā)現，無需顯式導入
支持功能：夾具(fixture)、鉤子函數(hooks)、插件配置

2. 基礎環(huán)境搭建

安裝 pytest：
```
pip install pytest
```

創(chuàng)建項目結構：

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

3. 夾具(fixture)實戰(zhàn)

場景：多個測試用例共享數據庫連接
在 conftest.py 中添加：

import pytest
import psycopg2

@pytest.fixture(scope="module")
def db_connection():
    """創(chuàng)建數據庫連接（模塊級共享）"""
    conn = psycopg2.connect("dbname=test user=postgres")
    yield conn  # 測試執(zhí)行時返回連接
    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):
    """在報告中顯示自定義環(huán)境信息"""
    return "測試環(huán)境: Production v2.1 | 執(zhí)行人: ${USER}"

運行測試時將顯示：

============================ test session starts ============================
測試環(huán)境: Production v2.1 | 執(zhí)行人: alice

5. 作用域控制

層級	說明	示例路徑
目錄級	影響當前目錄及子目錄	`/tests/conftest.py`
多級嵌套	支持不同目錄的獨立配置	`/tests/api/conftest.py`
全局	項目根目錄的配置全局生效	`/conftest.py`

優(yōu)先級規(guī)則：

子目錄 > 父目錄
就近原則

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. 最佳實踐

避免過度使用：僅在需要共享邏輯時使用
命名規(guī)范：夾具名稱應具有描述性（如 db_connection）
作用域選擇：
- function（默認）：每個測試函數執(zhí)行一次
- class：每個測試類執(zhí)行一次
- module：每個模塊執(zhí)行一次
- session：整個測試會話執(zhí)行一次

調試技巧：查看夾具生效情況

pytest --fixtures  # 顯示所有可用夾具

8. 完整示例

項目結構：

project/
├── conftest.py                 # 全局配置
├── tests/
│   ├── conftest.py             # 測試目錄配置
│   ├── test_api.py
│   └── web/
│       ├── conftest.py         # 子目錄專屬配置
│       └── test_ui.py

層級配置生效順序：