根本原因是pytest推断的“测试根目录”（rootdir）与conftest.py实际位置不匹配；rootdir由命令行路径向上查找首个配置文件（如pyproject.toml）确定，conftest.py必须位于该rootdir及其子目录内才被加载。
pytest 找不到 conftest.py，根本原因不是“文件不存在”，而是它压根没在你预期的位置搜索——conftest.py 的加载完全依赖 pytest 推断出的“测试根目录”，而不是你当前执行命令的路径，也不是项目 Git 根目录。
pytest 怎么确定 rootdir？
它从你传给 pytest 的参数（比如 test_unit/、tests/test_api.py）出发，**向上逐级查找**，直到遇到第一个含以下任一配置文件的目录：
pytest.ini-
pyproject.toml（且含[tool.pytest.ini_options]） tox.inisetup.py
这个目录就是 rootdir；如果全都没找到，就用最外层测试路径本身作为 rootdir。所有 conftest.py 必须位于该 rootdir 及其子目录中才有效。
验证方法：运行 pytest --debug，看输出里 rootdir: 后面的路径是否符合你预期。如果显示的是 /path/to/project/test_unit，而你的 conftest.py 在 /path/to/project/tests/，那它必然被忽略。
conftest.py 放对位置但 still not loaded？
常见硬伤：
- 文件名拼错：
conf_test.py、conftest.PY、conftest.pyc—— pytest 只认严格小写的conftest.py - 所在目录不是 Python 包：没有
__init__.py（尤其在 pytest ≤ 7.3 或涉及跨包 import 时，会导致 fixture 不注册） - 多个
conftest.py冲突：离测试文件更近的那个会屏蔽上层同名 fixture，但如果你只看到“fixture not found”，大概率是根本没加载到任何 conftest - pytest ≥ 7.4.0 的默认行为变更：若项目根目录下**没有配置文件**（如空的
pytest.ini），它可能不会向上推到你认为的项目根，而是卡在测试子目录 —— 最快解法：在项目根建个空pytest.ini
为什么加了 pythonpath=. 还是找不到 fixture？
pythonpath=. 只影响 Python 模块导入路径（比如 import mylib），**不影响 conftest.py 的发现逻辑**。这是两个独立机制：
-
conftest.py加载：纯靠rootdir+ 目录树扫描 - 模块导入：靠
PYTHONPATH/pythonpath=/sys.path
所以你在 conftest.py 里写 from mypkg.utils import helper 报 ModuleNotFoundError，那是导入问题；但 fixture 'helper' not found，说明 conftest.py 根本没被加载进来。
怎么快速定位和修复？
别猜，直接验证：
- 把
conftest.py复制一份放到你当前执行pytest的目录下，如果 fixture 立刻生效 → 坐实是rootdir定位问题 - 运行
pytest --collect-only -v，观察测试项路径前缀是否合理（比如是test_foo.py::test_bar而不是tests/unit/test_foo.py::test_bar） - 检查
pyproject.toml是否有testpaths = ["tests"]，它会强制重设搜索起点，但不改变rootdir推断
真正起作用的永远是 rootdir —— 它决定了 conftest 的搜索边界，也决定了相对路径的基准点。很多人花半天调路径，其实只是没看清这一行 rootdir: ... 输出。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
