pytest报unrecognized arguments错误，根本原因是参数未被注册：插件未安装（如--html需pytest-html）、conftest.py未加载或位置错误、参数拼写/定义不匹配、addopts中使用了未注册的参数，或IDE缓存导致插件未生效。
pytest 命令行参数解析失败，根本原因不是参数写错了，而是 pytest 根本没“认出”你传的参数——它压根没定义过这个选项。
为什么 pytest 报 unrecognized arguments 错误
这个错误信息 unrecognized arguments: --html 或 --myoption 出现时，说明 pytest 的 argument parser 在解析命令行时遇到了一个它没见过的 flag。它不关心你是不是装了对应插件，只按当前已注册的参数列表硬匹配。
- 最常见场景：想用
--html=report.html却没装pytest-html——pip install pytest-html后才会注册该参数 - 自定义参数（如
--env=staging）写在conftest.py里，但文件位置不对（比如放在 tests/subdir/ 下，而 pytest 是从项目根运行的），导致钩子函数没被加载 - 拼写错误：写了
--my-opt，但pytest_addoption里定义的是--myoption；或漏了双横线，写成-myoption - 参数值未提供：定义时用了
action="store"却只传--myoption没跟值，pytest 会把它当另一个未定义参数处理
自定义参数在 conftest.py 中不生效的典型原因
即使 conftest.py 文件存在，pytest 也不一定执行里面的 pytest_addoption。它只加载「测试收集路径内」且「离当前测试文件最近」的那个 conftest.py。
- 如果你在
tests/unit/下运行pytest test_foo.py，pytest 只会加载tests/unit/conftest.py，不会上溯到项目根目录 -
pytest_addoption函数名必须完全一致，大小写、下划线都不能错；函数必须是模块顶层定义，不能套在 if 或类里 - 定义参数时用了
dest，但后续用request.config.getoption("--myoption")时仍要传原始名字（--myoption），不是dest值 - Pytest 6.0+ 默认启用
import_mode=importlib，可能导致部分conftest.py加载时机异常；可显式加--import-mode=append测试是否与此有关
如何验证参数是否真被注册
别靠猜，直接让 pytest 吐出它认识的所有参数：
立即学习“Python免费学习笔记（深入）”；
- 运行
pytest --help | grep "myoption"（把myoption换成你的参数名）——如果没输出，说明钩子根本没跑 - 在
conftest.py开头加一行print("conftest loaded")，再跑pytest --help，看有没有这行输出；没有就证明该文件未被加载 - 检查
pytest --version输出中是否有你依赖的插件名（如pytest-html-4.1.1），没有就说明插件未安装或未正确发现 - 临时删掉所有
addopts配置（pytest.ini或pyproject.toml里的），排除配置项干扰
容易被忽略的隐性冲突点
参数名看似独立，实则可能被其他插件抢占或覆盖：
- 两个插件都注册了
--verbose，但实现不同，pytest 通常只认第一个（取决于加载顺序） - 你在
pyproject.toml的[tool.pytest.ini_options]里写了addopts = ["--myoption=value"]，但该参数还没被任何钩子注册，pytest 会在启动早期就报错退出 - 使用
pytest-xdist并行时，某些插件的参数注册逻辑可能失效（尤其动态 patch 的插件），建议先关掉-n排查 - IDE（如 PyCharm）内置的 pytest runner 可能缓存旧的插件状态，改完
conftest.py后需重启测试进程，不能只点重跑
