打包的pytest框架中conftest.py无法加载Fixture的问题咨询

核心原因 #

pytest对conftest.py的加载逻辑是仅扫描当前测试执行目录及其向上的父目录，不会主动搜索已安装Python包（比如site-packages里的MyTestFrameWork）中的conftest.py。这是因为conftest.py的设计定位是测试项目本地的配置文件，用来给当前项目提供专属的Fixture和钩子，并非为跨项目分发复用而生。

当你把Fixture移到__init__.py时，外部项目导入你的包后，这些Fixture会被Python的模块导入机制加载，同时pytest会自动识别模块中定义的Fixture（只要模块被导入），所以就能正常使用了。

正确的配置方式（避免依赖__init__.py） #

如果不想把Fixture塞到__init__.py里，有两种更规范的做法：

1. 显式导入并注册Fixture #

• 在你的框架包内新建一个模块（比如MyTestFrameWork/fixtures.py），把所有Fixture定义在这里。
• 在外部测试项目的conftest.py中导入这些Fixture，按需直接引用或二次封装：

  from MyTestFrameWork.fixtures import my_global_fixture
  
  # 若需修改逻辑，可重新装饰
  @pytest.fixture
  def custom_fixture(my_global_fixture):
      return my_global_fixture + " custom"
  

2. 做成标准pytest插件 #

如果你的框架是作为pytest插件分发，可在setup.py（或pyproject.toml）中配置pytest的入口点：

• 针对setup.py的示例配置：

  from setuptools import setup
  
  setup(
      name="MyTestFrameWork",
      # 其他配置项...
      entry_points={
          "pytest11": [
              "MyTestFrameWork = MyTestFrameWork.fixtures",
          ]
      }
  )
  

  安装后，pytest会自动识别并加载MyTestFrameWork.fixtures中的所有Fixture，外部项目无需额外导入就能直接使用。

另外，也可以在包的__init__.py中定义pytest_plugins变量，指定要加载的Fixture模块：

# MyTestFrameWork/__init__.py
pytest_plugins = ["MyTestFrameWork.fixtures"]

这种方式不需要配置entry-points，安装后pytest同样会自动加载指定模块里的Fixture。

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