@scenario必须与.feature文件中Scenario名称完全一致（含空格标点），否则静默跳过；@given/@when/@then装饰器字符串需正则匹配.feature中对应步骤文本，参数用{name}捕获并传参，上下文通过context对象共享。
pytest-bdd 的 @scenario 和 @given/@when/@then 怎么配对？
必须保证 feature 文件中的 scenario 名称与 Python 中 @scenario 装饰器的路径+名称完全一致（包括空格和标点），否则 pytest-bdd 会跳过该场景，不报错也不执行。常见错误是 feature 文件里写 Scenario: 用户登录成功，但 Python 中写了 @scenario("features/login.feature", "用户登录") —— 少了“成功”二字就断连。
步骤函数（@given/@when/@then）的函数名本身无关紧要，关键在装饰器里的字符串是否能匹配 feature 文件中对应行的文本。支持正则捕获，比如 @then("用户看到提示消息 <code>{message}") 能匹配 用户看到提示消息 "登录成功"，其中 message 会作为参数传入函数。
- feature 文件路径用相对路径，从 pytest 执行目录算起（不是从 test_*.py 所在目录）
- 同一个 step 函数可被多个
@given或@then复用，只要字符串匹配上 - 不要在 step 函数里写 assert；断言逻辑应放在
@then对应的函数里
为什么 pytest 运行时提示 StepDefinitionNotFoundError？
这不是代码语法错，而是 pytest-bdd 没找到某个 Gherkin 步骤对应的 Python 函数。最常见原因有三个：拼写/空格不一致、step 函数没被 import 进 conftest.py 或测试文件、或者函数定义在类内部但没加 @staticmethod（pytest-bdd 不支持实例方法绑定的 step）。
调试建议：运行 pytest --bdd-show-step-matches，它会列出所有已注册的 step 定义及其正则模式，方便你核对 feature 文件里的原文是否真能被某个 pattern 匹配上。注意：中文字符需确保 .feature 文件保存为 UTF-8 编码，且 Python 文件顶部有 # -*- coding: utf-8 -*- 声明。
立即学习“Python免费学习笔记（深入）”；
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 避免在 step 函数名里用下划线代替空格（如
user_sees_message），而应在装饰器字符串里写完整自然语言 - 如果用了参数化（
{id}、{email}），确保 feature 文件中对应位置的值不包含斜杠、括号等干扰正则解析的字符 - conftest.py 是推荐的 step 注册位置，但必须被 pytest 导入到测试作用域——检查是否漏了
__init__.py或路径导入问题
如何让 @given 初始化的数据在 @when 和 @then 中复用？
pytest-bdd 默认不共享 step 函数之间的局部变量。正确做法是把上下文数据挂到 context 对象上，这个对象由 pytest-bdd 在每个 scenario 执行期间自动注入并传递给所有 step 函数（前提是函数签名里显式声明 context 参数）。
例如：@given("一个未登录的用户") 对应的函数可以写 def _(context): context.user = User(name="test")；后续 @when("用户提交登录表单") 就能通过 context.user 访问同一实例。注意：不要用全局变量或模块级变量模拟上下文，会导致 scenario 间污染。
- context 是 dict-like 对象，支持
context["key"] = value和context.key = value两种赋值方式 - 每个 scenario 独享一个 context 实例，无需手动清理
- 如果 step 函数不需要 context，就别在参数里写它；多写一个没用的参数会导致调用失败
pytest-bdd 和纯 pytest 单元测试能混用吗？
可以，但要注意 fixture 作用域冲突。pytest-bdd 内部会注册自己的 fixture（如 scenario, feature），如果你在 conftest.py 里定义了同名 fixture，pytest 会优先使用你定义的，导致 bdd 行为异常。更隐蔽的问题是：bdd 场景中调用的 @given 函数若依赖某个自定义 fixture（比如 database），必须显式声明为参数，不能靠 autouse=True 自动注入——因为 pytest-bdd 不参与 pytest 的 fixture 解析链。
建议策略：把 bdd 相关的 fixture 全部放在单独的 bdd_conftest.py，并在 pytest.ini 中通过 testpaths = features tests 明确测试入口；非 bdd 测试保持用标准 pytest 结构。这样既隔离又共存。
- 不要在
@given函数里直接调用pytest.fixture，它不在 pytest 的 fixture 上下文中 - 需要共享 setup/teardown 逻辑时，用
@scenario的example_converters或外层 fixture + context 传递结果 - 混合项目里，
pytest --tb=short -v比默认输出更能快速定位是 bdd 步骤失败还是普通断言失败
实际落地时最容易被忽略的是：feature 文件的缩进和冒号后空格必须严格符合 Gherkin 规范，少一个空格就可能让整段 step 被忽略，而且 pytest-bdd 不报任何提示。
