pytest-bdd的核心机制是将gherkin语法.feature文件映射为pytest测试用例，通过@given/@when/@then装饰器绑定步骤定义函数，由pytest按生命周期执行，不自动管理状态，依赖fixture注入共享资源。
pytest-bdd 的核心机制是什么？
pytest-bdd 不是独立测试框架，而是把 Gherkin 语法（.feature 文件）翻译成 pytest 测试用例的插件。它不运行步骤定义，只做映射：每个 @given/@when/@then 装饰器绑定到一个 Python 函数，pytest 执行时按顺序调用这些函数——和普通 pytest 测试一样走 setup/teardown 生命周期。
这意味着你不能指望它自动管理状态（比如页面对象、数据库连接），所有上下文必须显式传递或通过 pytest fixture 注入。
-
feature文件只负责描述行为，不包含逻辑；真正执行的是步骤定义函数 - 步骤定义函数名不必和 feature 中的句子一致，靠装饰器里的字符串匹配（支持正则）
- 同一个 step 可以被多个场景复用，但参数捕获需严格对应（例如
@when("I click the <button> button")</button>要求函数签名含button参数）
如何正确组织 feature 和步骤定义文件？
目录结构松散，但推荐按功能模块划分，避免跨目录引用混乱。pytest-bdd 默认在 features/ 下找 .feature，步骤定义默认在 features/steps/ 下找 Python 模块。
常见错误是步骤定义没被发现：不是路径不对，就是没加 pytest_plugins = "pytest_bdd" 到 conftest.py 或 pyproject.toml。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 确保
conftest.py在 features 目录同级或更上层，并包含pytest_plugins = "pytest_bdd" - 步骤定义文件必须以
.py结尾，且至少有一个带@given/@when/@then的函数 - 不要在步骤定义里 import 同目录下其他未被 pytest 加载的模块（容易触发循环导入）
怎样让 step 函数访问 fixture 或共享状态？
直接传参只适用于简单值（如字符串、数字）。复杂对象（如 WebDriver 实例、API client）必须用 pytest fixture 注入，否则 step 函数无法感知生命周期或复用资源。
pytest-bdd 支持在 step 函数签名中声明 fixture 名，pytest 会自动 resolve。但注意：fixture 必须已注册（在 conftest.py 中定义），且 scope 合理（function 最安全，session 需谨慎）。
- 写法示例：
@when("I navigate to the login page")对应函数def i_navigate_to_the_login_page(browser):，其中browser是已定义的 fixture - 不要在 step 函数里手动创建 driver 或 session——这会绕过 pytest 的 fixture 管理，导致 teardown 失败或资源泄漏
- 若需跨 step 传递数据（如登录后返回的 token），用 fixture 返回字典或自定义对象，而非全局变量
为什么某些 step 总是报 StepDefinitionNotFoundError？
这个错误表面是“找不到步骤定义”，实际原因通常是字符串匹配失败，而不是文件没加载。pytest-bdd 用正则匹配 step 文本，默认开启模糊匹配（忽略空格、标点差异），但仍有边界条件。
- 检查 step 文本是否含不可见字符（如全角空格、零宽空格），复制 feature 中的原文到装饰器里最保险
- 正则捕获组命名要一致：
@then("the response status code is <code>")要求函数参数名为code，不能写成status_code - 如果用了引号包裹变量（如
"user name is 'Alice'"），装饰器里也要加单引号：@then("user name is '(.*)'")
真正难调试的是多 step 共享 fixture 时的 scope 冲突，或者 conftest.py 里 fixture 定义位置不对——这些不会报 StepDefinitionNotFoundError，但会导致 step 执行时参数为 None 或抛 AttributeError。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
