pytest_addoption钩子函数必须在conftest.py中实现，用于注册自定义命令行选项；参数通过pytestconfig.getoption("--name")读取，且conftest.py须置于测试根目录，否则报unrecognized arguments。
如何在pytest中注册自定义命令行选项
pytest本身不支持直接在测试文件里定义命令行参数，必须通过插件机制注入。核心方式是实现pytest_addoption钩子函数，在conftest.py中声明参数，否则运行时会报错unrecognized arguments。
这个函数必须放在项目根目录或测试目录下的conftest.py中（不能放在.py测试文件里），且名称不能拼错——少个s或大小写错误都会导致参数无效。
常见错误现象：运行pytest --myflag value时提示unrecognized arguments: --myflag，基本就是conftest.py缺失、位置不对，或钩子函数名写成了pytest_add_options之类。
- 推荐始终把
conftest.py放在最外层测试目录（如tests/conftest.py），避免路径嵌套导致加载失败 - 使用
parser.addoption()时，action参数要按需选："store"（默认）、"store_true"（布尔开关）、"append"（收集多个值） - 务必为
default设明确值（比如None或空字符串），否则在未传参时取值可能引发AttributeError
如何在测试函数中读取自定义参数值
注册完参数后，不能用sys.argv或argparse去解析——pytest已接管命令行，所有参数都统一挂载到request.config对象上。正确做法是通过pytestconfig fixture获取。
注意：pytestconfig是session级fixture，只能在函数、类或模块作用域使用，不能在setup_method等方法内部直接调用request.config.getoption()（因为request此时不可用）。
- 在测试函数签名中声明
pytestconfig参数即可注入：def test_something(pytestconfig): - 用
pytestconfig.getoption("--myflag")读值，key必须带--前缀，和注册时的name一致 - 如果参数是
action="store_true"，未传参时返回False；传了则返回True，无需额外判断is not None - 避免在
conftest.py的pytest_runtest_makereport等钩子里直接读取——此时pytestconfig可能尚未完全初始化
如何让自定义参数影响测试执行逻辑（比如跳过/条件运行）
拿到参数值后，典型用法是结合pytest.skip()或pytest.exit()控制流程。但要注意：跳过必须发生在测试执行阶段（即setup或call阶段），不能在collection阶段硬跳，否则会破坏pytest的收集机制。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
更稳妥的方式是用pytest_collection_modifyitems钩子，在测试项被收集后、执行前统一过滤。这样既避免每个测试都重复判断，又能保证跳过信息显示在终端里（比如标为skipped而非error）。
- 在
conftest.py中实现pytest_collection_modifyitems(config, items) - 用
config.getoption("--env")读参数，再遍历items，对不满足条件的调用item.add_marker(pytest.mark.skip(reason="...")) - 不要在
pytest_runtestloop里用os._exit()强行中断——这会跳过teardown，导致资源泄漏 - 若参数用于控制fixture行为（如数据库连接地址），应在fixture内部读取
pytestconfig，而不是在测试函数里传参
为什么自定义参数在IDE（PyCharm/VS Code）中不生效
IDE运行pytest时通常不会自动加载项目根目录的conftest.py，尤其当工作目录（Working Directory）设错时。PyCharm默认用测试文件所在目录作为cwd，如果conftest.py在上层，就找不到。
错误表现：命令行能跑通pytest --myflag abc，但IDE里点“Run”就报unrecognized arguments。
- PyCharm：进
Run → Edit Configurations → Test Configuration → Working directory，改成项目根目录（含conftest.py的位置） - VS Code：检查
.vscode/settings.json中是否有"python.testing.pytestArgs"，确保没覆盖掉自定义参数；同时确认python.defaultInterpreterPath指向正确环境 - 终极验证法：在
conftest.py的pytest_addoption开头加print("conftest loaded")，看IDE运行时是否输出——没输出就是根本没加载 - 不要依赖
__init__.py触发加载：conftest.py不是Python模块，不走import机制
参数名冲突、钩子函数位置错误、IDE工作目录偏差——这三个点占了90%以上的自定义参数失败案例。只要逐项核对，基本都能定位到根源。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
