必须在conftest.py中定义pytest_addoption钩子函数声明参数，通过request.config.getoption()在fixture或测试函数内安全读取，默认值必设，且ini文件中的addopts仅启用已声明的参数。
如何在 conftest.py 中正确注册自定义命令行参数
pytest 本身不支持直接在测试函数里读取任意命令行参数，必须通过 pytest_addoption 钩子提前声明，否则运行时会报错 unrecognized arguments。这个钩子只能在 conftest.py（或 pytest 插件）中定义，且必须是模块级函数。
常见错误是把 pytest_addoption 写在 test_*.py 文件里，或者写成类方法、嵌套函数——这些都不会被 pytest 发现。
- 确保
conftest.py位于测试目录根路径或其父级，且文件名拼写完全正确（不能是conftest.pyc或大小写错误） - 函数签名必须是
def pytest_addoption(parser):，参数名不能改，类型检查严格 - 推荐统一用
parser.addoption(..., action="store", default=...)，避免store_true类型和字符串值混用导致类型不一致
怎么在测试中安全读取自定义参数的值
参数注册后，不能直接用 sys.argv 或 argparse 解析——pytest 已接管命令行，必须通过 request.config.getoption() 获取。这个调用必须在 fixture 或测试函数中进行，且要处理参数未传入时的默认值。
典型陷阱是：在模块顶层就调用 getoption()，此时 pytest 还没初始化配置对象，会抛 AttributeError: 'NoneType' object has no attribute 'getoption'。
立即学习“Python免费学习笔记（深入）”；
- 只在 fixture 函数体内部或测试函数内调用
request.config.getoption("--my-param") - 始终传
default=...，比如request.config.getoption("--env", default="staging")，不要依赖None做逻辑分支 - 如果多个测试文件共享同一参数，建议封装成 fixture，用
@pytest.fixture(scope="session")提前加载一次
为什么 --xxx 参数在 pytest.ini 里设了也不生效
pytest.ini / pyproject.toml 中的 addopts 只影响 pytest 启动时的默认选项，它不会“预注册”参数。也就是说，addopts = --my-flag 必须配合已在 pytest_addoption 中声明过的 --my-flag 才有效；否则照样报 unrecognized arguments。
另一个常见误解是以为在 pytest.ini 里写 my_flag = value 就能替代命令行——不行，ini 文件不支持未声明的自定义键。
-
pytest_addoption是“声明”，addopts是“默认启用”，二者缺一不可 - ini 文件中若使用
[tool:pytest]（旧格式）可能被忽略，优先用[tool.pytest.ini_options]（pyproject.toml）或[pytest]（pytest.ini） - 环境变量方式（如
PYTEST_ADDOPTS="--my-param prod"）同样依赖参数已声明
字符串参数带空格或特殊字符时怎么避免解析失败
当自定义参数值含空格（如 --desc "login with SSO"），shell 层面需加引号，但 pytest 内部仍按字符串接收。真正容易出问题的是值里含等号、逗号或反斜杠——它们可能被误判为分隔符或转义序列。
根本原因在于 pytest 使用 argparse 解析，而 argparse 对 = 的处理很敏感：用 --key=value 和 --key value 两种写法行为不同，尤其当 value 本身含 = 时。
- 强制使用空格分隔：调用时写
pytest --my-param "a=b=c"，而非--my-param=a=b=c - 在
addoption中显式指定nargs=1（默认就是），避免nargs="*"导致意外截断 - 如果值来自 CI 环境变量，先用
shlex.quote(os.environ.get("MY_PARAM", ""))包裹再拼进命令行
最常被跳过的细节是：同一个参数在多个 conftest.py 中重复声明（比如子目录也有），pytest 不会合并或报错，而是静默覆盖——最终生效的是离测试文件最近的那个 conftest.py 里的定义。
