Pytest 测试用例生命周期管理-自动注册(conftest.py)

conftest.py 文件简介

在 pytest 中,conftest.py 是一个特殊的配置文件,通常用于定义共享的 fixture、hooks 或其他全局设置,供整个项目中的测试使用。

conftest.py 文件可以帮助你管理项目级别的配置、共享的测试功能、预处理和清理操作,使得多个测试文件能够共享同一组配置或资源,而不需要在每个测试文件中重复定义。

conftest.py ⽂件名是固定的,不可以变化。


conftest.py 的生效规则

  • conftest.py 必须放在项目的根目录下,并且文件名固定不可变化

    python 复制代码
    tests/
    ├── conftest.py   ✅ 作用于当前目录及子目录
    ├── test_a.py
    │
    └── sub_tests/
        ├── test_b.py ✅ 也能用

运行机制

  • 🔹 自动加载 :当运行 pytest 时,pytest 会自动搜索并加载当前目录及其上层目录中的 conftest.py 文件。不需要显式地导入 conftest.py 中定义的 fixtures,它们会自动成为测试文件的一部分。

  • 🔹 作用范围conftest.py 中定义的内容具有全局作用。conftest.py 文件会应用于当前目录及其子目录下的所有测试文件。

  • 🔹 目录层级 :pytest 会逐级向上查找 conftest.py 文件。如果某个测试文件位于子目录中,它会加载该子目录下的 conftest.py 文件,并且会继续加载父目录的 conftest.py 文件,直到找到项目根目录下的 conftest.py


使用场景

  • 多个测试文件共用同一资源

  • 团队协作

  • 框架级能力扩展

使用步骤

  • 创建 conftest.py 文件:通常放在项目的根目录或一个特定的测试子目录中。
  • conftest.py 文件中定义 fixture 或者 hooks。
  • 在测试用例中直接传入 fixture 名字,不需要在测试文件中导入。

代码示例

在项⽬根目录下创建 conftest.py 文件。
conftest.py 文件中定义登录和连接数据库两个 fixture。
在测试用例中直接传入以上两个 fixture 名称。

  • conftest.py

    python 复制代码
    import pytest
    
    @pytest.fixture(scope="class")
    def login():
         # setup 操作
         print("完成登录操作")
         token = "abcd"
         username = 'hogwarts'
         yield token,username # 相当于return
         # teardown 操作
         print("完成登出操作")
    
    @pytest.fixture()
    def connectDB():
         print("连接数据库")
         yield
         print("断开数据库")
  • test_get_product.py

    python 复制代码
    def test_get_product(login, connectDB):
        print("验证获取单品信息")
    • 运行结果
相关推荐
nbwenren20 小时前
2026实测:Gemini 3.1 Pro 从需求文档到 pytest 测试用例一条龙教程
测试用例·pytest
其实防守也摸鱼21 小时前
CSDN博客写什么?从0到1打造你的技术影响力
笔记·测试用例·博客·教程·ai写作·ai辅助·高质量
我的xiaodoujiao1 天前
API 接口自动化测试详细图文教程学习系列16--项目实战演练3
python·学习·测试工具·pytest
我的xiaodoujiao2 天前
API 接口自动化测试详细图文教程学习系列15--项目实战演练2
python·学习·测试工具·pytest
孙高飞2 天前
AI生成接口自动化测试用例最佳实践(附skill设计思路)
运维·自动化·测试用例
qq_452396232 天前
第十六篇:《如何高效维护UI自动化测试用例:避免“维护地狱”》
ui·自动化·测试用例
技术钱3 天前
PyTest配置与API测试用例
servlet·测试用例·pytest
测试19983 天前
接口测试工具:Postman的高级用法
自动化测试·软件测试·python·测试工具·测试用例·接口测试·postman
程序员小远3 天前
如何编写测试用例?
自动化测试·软件测试·python·功能测试·测试工具·职场和发展·测试用例