如何解决Python测试中找不到conftest.py文件问题_检查项目根目录结构-Python教程-PHP中文网

pytest未自动发现conftest.py是因为其只在推断出的“测试根目录”（从命令行路径向上找到首个配置文件所在目录）及其子目录中查找；若conftest.py位于该根目录之外、非包目录、文件名错误或存在缓存，均会导致失效。

如何解决python测试中找不到conftest.py文件问题_检查项目根目录结构

conftest.py 为什么没被 pytest 自动发现

pytest 只在“测试根目录”及其子目录里找 conftest.py，这个根目录不是你当前执行命令的路径，而是 pytest 自动推断出的“项目根”——它从命令行参数（如测试文件路径、目录）出发，向上回溯到第一个包含 pytest.ini、pyproject.toml、tox.ini 或 setup.py 的父目录；如果都没找到，就用最外层的测试路径作为根。

常见错误现象：ImportError 报无法导入 conftest 里的 fixture，或 fixture 名称报 fixture 'xxx' not found，但文件明明存在。

你在子目录里执行 pytest test_unit/，而 conftest.py 放在更上层的 tests/ 目录下 —— pytest 根目录可能卡在 test_unit/ 这一级，根本不会往上找
conftest.py 放在了非 Python 包目录中（比如没带 __init__.py），pytest 虽能读取文件，但其中定义的 fixture 不会被自动注册（尤其涉及模块级 import 时）
文件名拼错：比如 conftest.py 写成 conf_test.py 或 conftest.pyc，pytest 完全忽略

怎么确认 pytest 当前识别的根目录

运行 pytest --debug，输出里会有一行类似 rootdir: /path/to/your/project，这就是 pytest 实际使用的根目录。它决定了 conftest.py 的搜索范围（只查该目录及所有子目录）。

也可以用 pytest --collect-only 配合 -v，看收集到的测试项路径是否符合预期；如果路径显示为 test_foo.py::test_bar 而不是 tests/unit/test_foo.py::test_bar，说明根目录可能太深了。

想强制指定根目录？加 --rootdir=/path/to/tests 参数，但注意这不会改变 Python 模块导入路径，仅影响配置查找
检查 pyproject.toml 是否有 [tool.pytest.ini_options] 配置，它可能覆盖默认行为（比如设置了 testpaths = ["tests"]）
临时验证：把 conftest.py 复制一份放到当前执行命令的目录下，如果 fixture 突然生效，就坐实是根目录定位问题

conftest.py 放在哪才真正起作用

位置决定作用域：conftest.py 必须放在它要影响的测试文件的**共同父目录**里，且该目录需被 pytest 视为有效搜索路径（即位于根目录之下）。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

典型结构推荐（以 tests/ 为根）：

project/
├── pyproject.toml          # pytest 根据此文件定位 rootdir
├── src/
│   └── mypackage/
├── tests/
│   ├── conftest.py           # 全局 fixture，对所有 tests/ 下测试生效
│   ├── unit/
│   │   ├── conftest.py       # 仅对 tests/unit/ 及其子目录生效
│   │   └── test_core.py
│   └── integration/
│       └── test_api.py

不要把 conftest.py 放在 src/ 或项目根（无配置文件时），pytest 很可能不把它当配置目录
如果使用 src 布局，确保 pyproject.toml 存在且 rootdir 能正确锚定到含 tests/ 的层级
多个 conftest.py 可以共存，但同名 fixture 会被就近的覆盖（就近原则），调试时容易混淆

为什么 conftest.py 里的 fixture 还是不生效

文件找到了，路径也对，但 fixture 就是报找不到——大概率是 Python 导入机制和 pytest fixture 注册时机的错位。

conftest.py 不是普通模块：它不能被 import conftest，pytest 是直接 exec 执行它的全局命名空间；所以里面不能依赖相对导入（如 from ..utils import helper），会报 SystemError: Parent module '' not loaded
fixture 函数名不能以下划线开头（如 _setup_data），pytest 会跳过它
如果用了 @pytest.fixture(scope="session")，但 conftest.py 在子目录里，而 session 级 fixture 要求定义在 rootdir 下的 conftest.py 中，否则会被忽略
Pytest 7.0+ 对 conftest.py 编码更敏感：确保文件保存为 UTF-8 无 BOM，否则可能静默失败