pytest插件必须通过setuptools的pytest11入口点注册，定义合法钩子函数（如pytest_addoption），并以pip install -e .安装；命令行参数需在pytest_addoption中注册，通过request.config.getoption('--xxx')读取；fixture需用@pytest.fixture(autouse=True)声明；钩子函数名与签名必须严格匹配，否则静默失效。
如何注册自定义pytest插件并确保被正确加载
pytest 插件必须通过 setuptools 的 entry_points 声明，否则 pytest 启动时根本不会识别它。直接把插件模块扔进项目目录、或用 sys.path.append() 添加路径，都无效。
关键步骤：
- 在
setup.py或pyproject.toml中声明pytest11入口点，名称任意（如myplugin），值为模块路径（如myplugin.plugin） - 模块内必须定义一个名为
pytest_configure或pytest_addoption等合法钩子函数，哪怕空实现——没有钩子函数的模块不会被当作插件加载 - 安装插件必须用
pip install -e .（开发模式），不能靠import手动导入后期望 pytest 自动发现
怎样在插件中添加命令行参数并读取其值
所有命令行参数必须通过 pytest_addoption 钩子注册，且只能在该钩子中调用 parser.addoption()；在 pytest_configure 或测试函数里调用会报错 ValueError: unknown option。
常见陷阱：
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 短选项名（如
-v）已被 pytest 占用，自定义参数请用长选项（--my-flag）或带前缀的短选项（--mp-verbose） -
action='store_true'参数在测试函数中通过request.config.getoption('--my-flag')获取，注意选项名要带--前缀 - 如果参数需在
conftest.py中提前使用（如影响 fixture 初始化），得用request.config.getoption()在 fixture 内部读取，不能在模块顶层读
如何编写 fixture 并让插件自动注入到所有测试作用域
插件中的 fixture 不需要 @pytest.fixture 装饰器显式标记为 autouse=True，而是通过 pytest_fixture_setup 或更稳妥的方式：在插件模块中定义 fixture 函数，并在 pytest_configure 里调用 config.addinivalue_line('markers', 'myfixture: custom fixture') 配合 pytest_runtest_makereport 控制时机——但最简单可靠的做法是直接用 pytest_generate_tests 或在 conftest.py 中 import 插件模块并声明 autouse=True fixture。
更推荐的实际做法：
- 在插件模块中定义普通函数（如
def my_db_connection(): ...） - 在同一个模块中加一个
@pytest.fixture(autouse=True, scope='session')包装它，并根据命令行参数决定是否启用 - 确保该 fixture 名称不与项目已有 fixture 冲突，否则 pytest 会静默覆盖（无警告）
为什么插件里的 hookimpl 有时不触发？
最常见的原因是钩子函数名拼写错误或参数签名不匹配。pytest 对钩子函数名和参数极其敏感——比如 pytest_runtest_makereport 少个 t，或参数写成 item 而不是 report，都会导致钩子完全不执行，且不报错。
调试建议：
- 用
pytest --debug查看日志，搜索hook关键字，确认你的插件是否被加载、钩子是否注册成功 - 在钩子函数开头加
print(f"[DEBUG] {hook_name} called")，不要依赖 logging —— pytest 的日志级别可能屏蔽输出 - 避免在钩子中做耗时操作（如网络请求），它运行在 pytest 主流程中，会拖慢整个测试启动或报告生成
插件机制本身轻量，但钩子执行时机和上下文非常具体，写错一个字母或漏掉一个必需参数，就等于没写。
