pytest-bdd仅将.feature文件转为pytest用例，执行依赖python函数实现；需正确绑定@given/@when/@then、匹配step名、处理参数提取、注意返回值传递链及作用域限制。
pytest-bdd 不能替代 pytest 写单元测试，它只负责把 Gherkin（.feature 文件）翻译成 pytest 测试用例；真正执行逻辑、断言、fixture 依赖，全靠你写的 Python 函数 —— 没写对 @given/@when/@then 绑定，或者 step 实现里抛了异常，测试就直接 fail，不会给你“行为未实现”的友好提示。
怎么让 .feature 文件被 pytest 发现并运行
pytest-bdd 默认只扫描当前目录及子目录下以 .feature 结尾的文件，且要求同名 Python 文件（或指定的 features/ 目录结构）中存在对应装饰器绑定。常见失败原因：
- 没在测试文件里 import
from pytest_bdd import given, when, then -
.feature文件放在tests/外，但没通过pytest --features path/to/features显式指定路径 - step 函数名和 feature 中的句子不匹配，比如 feature 写的是
Given I have a user "alice"，但 Python 里写了@given("I have an user {name}")（an → a，且缺少引号处理） - 没启用插件：确保
pytest-bdd已安装，并在pyproject.toml或pytest.ini中声明插件（新版 pytest 通常自动发现，但旧版可能需要addopts = --bdd）
@given/@when/@then 的参数怎么提取和传递
pytest-bdd 支持正则和字符串匹配两种方式提取参数，但默认用字符串匹配（更安全），正则需显式加 regex=True。关键点：
- 字符串匹配会自动处理双引号、单引号包裹的值，例如
Given I search for "python testing"→@given('I search for "{query}"')，query就是"python testing"（含空格，不含引号） - 如果要用正则，必须加
regex=True，且 group 名要和函数参数名一致：@when(r"I enter (?P<text>\w+)", regex=True)</text>→ 函数签名必须是def _(text): - 多个参数顺序必须严格对应，
@then("the result contains {count:d} items and status {status}")要求函数接收count（转为 int）和status两个参数 - 不要在 step 函数里做耗时操作（如发 HTTP 请求），应封装进 fixture，用
@given注入，否则无法复用、难 mock
为什么 step 函数里用 print() 看不到输出
pytest 默认捕获 stdout，所以 print() 不显示在终端。调试时要么加 -s 参数（pytest -s），要么改用 logging 并配置 level=DEBUG。更可靠的做法是：
- 在 step 函数开头加
import logging; logging.debug("step started")，配合pytest -s -l查看 - 别依赖 print 调试，优先用 IDE 断点 —— pytest-bdd 的 step 函数本质就是普通函数，可直接打断点
- 注意：
@given函数返回值会被传给后续@when和@then，所以如果 return 了对象，确保下游函数签名能接住（比如@given("I have user")返回user，那@when("I login")必须带user参数）
最常被忽略的是 step 函数的返回值传递链和 fixture 作用域混用 —— 一个 @given 返回的对象，默认只在当前 scenario 生效，跨 scenario 不共享；如果误以为它像 module 级 fixture 那样全局可用，就会遇到变量未定义或状态残留问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
