pytest未自动发现conftest.py是因为其只在推断出的“测试根目录”（从命令行路径向上找到首个配置文件所在目录）及其子目录中查找；若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，说明根目录可能太深了。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 想强制指定根目录？加
--rootdir=/path/to/tests参数，但注意这不会改变 Python 模块导入路径，仅影响配置查找 - 检查
pyproject.toml是否有[tool.pytest.ini_options]配置，它可能覆盖默认行为（比如设置了testpaths = ["tests"]） - 临时验证：把
conftest.py复制一份放到当前执行命令的目录下，如果 fixture 突然生效，就坐实是根目录定位问题
conftest.py 放在哪才真正起作用
位置决定作用域：conftest.py 必须放在它要影响的测试文件的**共同父目录**里，且该目录需被 pytest 视为有效搜索路径（即位于根目录之下）。
典型结构推荐（以 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，否则可能静默失败
最易被忽略的一点：pytest 缓存了旧的 __pycache__/conftest.cpython-*.pyc，改完 conftest.py 后没清缓存，导致行为和代码不一致。删掉整个 __pycache__ 目录再试。
