如何解决pytest特殊目录结构下子模块测试无法识别conftest.py的问题

核心原因 #

pytest的conftest.py是基于**测试根目录（rootdir）**加载的：每个被指定为独立测试路径（testpaths或命令行参数）的目录，会被当作单独的测试根，只会加载自身及上级目录（直到该根目录）的conftest.py。你当前的配置把../submodule/testing/设为独立测试路径，它和pytest目录是两个独立根，因此子模块的测试无法跨根加载主仓库的conftest.py。

可行解决方案 #

方案1：统一测试根目录+根目录放置conftest

这是最简洁的方案：

• 把原testing/pytest/conftest.py移动到repo根目录下（即repo/conftest.py）。
• 修改repo/testing/pytest.ini，添加根目录配置：

  [pytest]
  testpaths=
      pytest
      ../submodule/testing/
  rootdir = ..
  

• 直接在repo/testing目录下运行pytest即可，所有测试（主仓库和子模块）都会加载repo根目录的conftest.py里的fixture。

方案2：子模块conftest导入主仓库fixture

如果不想移动主仓库的conftest.py，可以在子模块目录创建一个中转的conftest.py：

• 在repo/submodule/testing/下创建conftest.py，内容为：

  # 导入主仓库conftest里的所有fixture
  from testing.pytest.conftest import *
  

• 修改repo/testing/pytest.ini，把repo根目录加入Python路径：

  [pytest]
  testpaths=
      pytest
      ../submodule/testing/
  pythonpath = ..
  

• 这样子模块的测试会通过自身的conftest.py导入主仓库的fixture，同时不改变原有目录结构。

方案3：命令行指定根目录（临时调试用）

如果只是临时验证，不需要修改配置文件，可以在运行pytest时手动指定根目录为repo：

# 在repo/testing目录下执行
pytest --rootdir=.. pytest/ ../submodule/testing/

这种方式会强制pytest以repo为根，自动加载repo根目录的conftest.py（如果已经移过去的话）。

注意事项 #

• 不要把不同测试路径设为独立的测试根，确保所有测试都归属于同一个rootdir下，这样conftest的作用域才能覆盖所有测试。
• 如果使用子模块的导入方案，要确保Python路径配置正确，避免出现导入错误。

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