pytest找不到conftest.py的根本原因是rootdir推断错误：它从测试路径向上查找首个含pyproject.toml等配置文件的目录作为rootdir，conftest.py必须位于该rootdir及其子目录内才被加载；文件名大小写、缺__init__.py、pytest≥7.4.0无配置文件时卡在子目录等细节也会导致失效。
pytest 找不到 conftest.py，不是文件丢了，而是它压根没在你认为的那个位置“看”——conftest.py 的加载完全由 pytest 推断出的 rootdir 决定，和你当前命令行在哪、Git 根在哪、甚至 __file__ 在哪都无关。
pytest 怎么确定 rootdir？
它从你传入的测试路径（比如 pytest tests/unit/ 或 pytest test_api.py）开始，**向上逐级查找**，直到遇到第一个含以下任一配置文件的目录：
-
pyproject.toml（且含[tool.pytest.ini_options]） pytest.initox.inisetup.py
这个目录就是 rootdir；所有 conftest.py 必须位于该目录及其子目录中才被加载。如果全都没找到，就用最外层测试路径本身当 rootdir。
验证方法：运行 pytest --debug，看输出里 rootdir: 后面的路径是否是你预期的。例如显示 rootdir: /home/user/myproj/tests/unit，但你的 conftest.py 在 /home/user/myproj/tests/，那它就被跳过了。
立即学习“Python免费学习笔记（深入）”；
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
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.py - 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推断错误 - 检查
conftest.py是否有语法错误或导入失败（比如ImportError会静默中断加载） - 确认测试文件是否真的在
rootdir子树内：比如rootdir是/a/b，而测试文件路径是/a/c/test_x.py，那它就不属于该rootdir范围
最易被忽略的一点：pytest 的 rootdir 和你心里认定的“项目根”经常不一致，尤其当 pyproject.toml 被放在某个子目录下时 —— 它不会“理解”你想共享 fixture 的意图，只机械执行向上查找逻辑。
