配置testpaths后pytest_addoption钩子未执行的问题排查

当你在项目根目录（与pyproject.toml同目录）执行pytest --foo bar时，pytest会优先从当前执行命令的目录加载初始conftest.py。如果你的conftest.py仅存在于testpaths指定的子目录中，pytest启动阶段不会加载这个子目录的conftest.py——因为testpaths仅用于指定测试用例的搜索路径，而非初始配置文件的加载路径。而pytest_addoption必须在pytest启动的初始加载阶段执行才能完成命令行选项的注册，这就导致--foo未被识别。

手动指定测试路径时，pytest会将你指定的路径作为初始搜索根目录，此时该目录下的conftest.py会被优先加载，所以选项能正常工作；但testpaths配置仅影响测试用例的查找逻辑，不会改变初始conftest.py的加载优先级，因此配置后问题依旧。

方案1：移动conftest.py到项目根目录 #

将包含pytest_addoption代码的conftest.py复制或移动到项目根目录（与pyproject.toml同级）。这样pytest启动时会首先加载根目录的conftest.py，完成命令行选项的注册，之后再正常加载testpaths目录下的其他测试资源和子目录conftest.py。

示例项目结构：

your_project/
├── pyproject.toml
├── conftest.py  # 存放pytest_addoption逻辑
└── tests/
    ├── test_demo.py
    └── (其他测试文件/子目录conftest.py)

方案2：将选项注册逻辑封装为本地pytest插件 #

如果不想移动conftest.py，可以把命令行选项的注册逻辑做成本地插件：

1. 在项目中创建插件目录，比如src/pytest_foo_plugin，并添加__init__.py文件：

# src/pytest_foo_plugin/__init__.py
def pytest_addoption(parser):
    parser.addoption("--foo", action="store", default=None, help="自定义foo选项")

2. 在pyproject.toml中配置pytest加载该插件：

[tool.pytest.ini_options]
pytest_plugins = ["pytest_foo_plugin"]
testpaths = ["tests"]

3. 确保src目录被Python识别为模块路径（可在pyproject.toml中添加[tool.setuptools.packages.find]配置，或临时设置PYTHONPATH=$PWD/src）。

这种方式下，无论从哪个目录启动pytest，插件都会被加载，命令行选项始终有效。

方案3：临时指定pytest根目录（快速验证用） #

执行pytest时，通过--rootdir参数指定包含目标conftest.py的目录作为根目录：

pytest --rootdir tests --foo bar

该方案无需修改文件，但每次执行都需附加参数，适合临时验证场景。

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