conftest.py找不到的根本原因是pytest仅在推断出的rootdir及其子目录中搜索，而非当前工作目录或git根目录；rootdir由命令行路径向上查找pyproject.toml、pytest.ini等配置文件确定，若未找到则以最外层测试路径为rootdir。

conftest.py 找不到，根本不是文件丢了，而是 pytest 根本没在你认为的位置搜它——它只认自己推出来的 rootdir，不认你当前终端在哪、也不认 Git 根目录。

---

pytest 怎么确定 rootdir？它根本不看你在哪敲的命令

pytest 从你传入的路径（比如 tests/unit/ 或 tests/test_api.py）开始，**向上逐级找配置文件**，一旦遇到以下任一文件就停，该目录就是 rootdir：

• pyproject.toml（且含 [tool.pytest.ini_options]）
• pytest.ini
• tox.ini
• setup.py

如果全都没找到，它就用你传入路径的最外层目录当 rootdir。所有 conftest.py 必须落在这个 rootdir 及其子目录里，才可能被加载。

验证方法：运行 pytest --debug，看输出里 rootdir: 后面的路径是不是你放 conftest.py 的父目录。如果不是，它就彻底无视那个文件。

conftest.py 放对了位置，还是不生效？检查这三处硬伤

• 文件名必须严格是 conftest.py：大小写敏感（conftest.PY、conf_test.py、conftest.pyc 全都不行）
• 所在目录要是 Python 包：必须有 __init__.py（尤其在 pytest ≤ 7.3 或跨包引用 fixture 时，缺它会导致 fixture 不注册）
• 多个同名 fixture 被静默覆盖：比如 tests/conftest.py 和 tests/integration/conftest.py 都定义了 @pytest.fixture def db()，后者会直接屏蔽前者，且不报错

为什么加了 pythonpath=. 还是报 fixture not found？

pythonpath=. 只影响 Python 模块导入（比如 import mylib），跟 conftest.py 的发现逻辑完全无关。这是两套独立机制：

python学习

Python 编程学习助手 skill，面向零基础用户。 当用户表达以下意图时触发： - 学习 Python 基础概念（变量、数据类型、循环、函数、类等） - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导（爬虫、数据分析、Web 开发等入门项目） - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill

下载

• conftest.py 加载：纯靠 rootdir + 目录树扫描
• 模块导入：靠 PYTHONPATH / sys.path

所以你在 conftest.py 里写 from mypkg.utils import helper 报 ModuleNotFoundError，那是导入失败；但测试里调用 helper fixture 报 fixture not found，说明 conftest.py 压根没被加载进来——别往 pythonpath 上猜。

pytest ≥ 7.4 启动时 rootdir 卡在子目录？补个空配置最稳

如果项目根目录下没有 pyproject.toml 或 pytest.ini，pytest ≥ 7.4 默认不会往上推到你认为的“项目根”，而是卡在你传入的测试子目录（比如 tests/）作为 rootdir。结果就是：你把 conftest.py 放在项目根，它看不见。

最快解法：在项目最外层目录建一个空的 pytest.ini 文件（内容可以就一行 [tool:pytest]）。这样它就能稳定把项目根识别为 rootdir，后续所有子目录下的测试都能正确继承上层 conftest.py。

真正容易被忽略的是：rootdir 是 pytest 自己推出来的，不是你“觉得应该是什么”。哪怕 conftest.py 文件存在、拼写正确、也有 init.py，只要它不在 rootdir 下，就等于不存在——连报错都不会有，只会静默跳过。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！