在pytest中注册自定义命令行参数需在conftest.py中正确定义pytest_addoption钩子函数，调用parser.addoption并指定dest；测试中通过request.config.getoption("dest")读取，推荐用session或function作用域fixture封装并做默认值与类型处理。
如何在pytest中注册自定义命令行参数
pytest允许通过pytest_addoption钩子函数在插件或conftest.py中声明自定义命令行参数。这个函数必须接收一个parser对象，调用其addoption方法完成注册。
关键点是：必须放在conftest.py（项目根目录或测试目录下）里，且函数名不能拼错；否则参数不会被识别。
-
addoption的dest参数决定后续如何在request.config.getoption(...)中获取值，推荐显式指定 - 支持
action="store_true"（布尔开关）、type=int（类型校验）、default=None（避免意外覆盖内置逻辑） - 短选项（如
-v）和长选项（如--verbose）可同时注册，但dest需一致
如何在测试中读取自定义参数值
注册完参数后，不能直接用sys.argv或argparse去解析——pytest已统一接管。正确方式是通过request.config.getoption("your_option_name")获取，通常配合pytest.fixture封装更安全。
注意：fixture作用域会影响调用时机。如果参数用于控制整个会话行为（比如跳过某些测试集），建议用scope="session"；若只影响单个测试逻辑，scope="function"即可。
- 未注册就调用
getoption会抛出ValueError: no option named 'xxx' - 未传参且没设
default时返回None，别假设它为False或空字符串 - 推荐在fixture里做默认值兜底和类型转换，例如：
int(request.config.getoption("--timeout", default=30))
常见错误：参数不生效或报错
最常遇到的是“参数被忽略”或“unknown option”错误，根本原因通常是路径或命名不匹配。
-
conftest.py不在pytest自动发现的测试目录树中（比如放在src/而非tests/下），pytest不会加载它 - 钩子函数写成
def pytest_add_options(parser):（少了个n），函数名错误导致钩子失效 - 使用
pytest.main()以编程方式运行时，未传入args列表（如["--myflag"]），参数不会注入配置 - 在
setup.cfg或pyproject.toml中配置了addopts，但拼写与addoption中dest不一致
一个最小可用示例
在项目根目录的conftest.py中：
def pytest_addoption(parser):
parser.addoption(
"--env",
action="store",
default="staging",
help="Environment to run tests against: dev/staging/prod"
)
@pytest.fixture(scope="session")
def env(request):
return request.config.getoption("--env")
运行时加参数：pytest --env=prod tests/test_api.py，fixture env就会返回"prod"。
实际项目中容易忽略的是多级conftest.py嵌套时的优先级——子目录下的conftest.py可以覆盖父目录同名钩子，但addoption只在首次导入时注册，重复注册会报错。所以建议把参数定义集中在顶层conftest.py。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
