pytest-lazy-fixture 是一个 pytest 插件，解决 @pytest.mark.parametrize 无法直接引用 fixture 名称的问题，通过 lazy_fixture("name") 实现参数化时延迟调用 fixture，确保 fixture 生命周期正确触发。
pytest-lazy-fixture 是什么，它解决什么问题？
pytest-lazy-fixture 的核心作用是：让 @pytest.mark.parametrize 能直接引用 fixture 名字，而不是 fixture 的返回值。
默认情况下，pytest 参数化不支持传入 fixture 名称——你只能传死值或计算好的结果；一旦 fixture 里封装了初始化逻辑（比如启动服务、准备测试数据、构造复杂对象），你就没法在参数化中“延迟调用”它。
常见错误现象：fixture 'db_session' not found 或参数化后 fixture 没被调用、报 TypeError: expected str, bytes or os.PathLike object——本质是把 fixture 对象当普通变量用了，没触发 pytest 的 fixture 生命周期。
怎么写才能让 parametrize 正确引用 fixture？
必须同时满足三个条件，缺一不可：
- 安装并导入：
pip install pytest-lazy-fixture，并在测试文件顶部加from pytest_lazy_fixture import lazy_fixture - 在
@pytest.mark.parametrize中，用lazy_fixture("fixture_name")包裹 fixture 名（注意是字符串） - 对应的 fixture 必须已定义，且 scope 合理（例如参数化用
function或class级 fixture）
示例：
import pytest
from pytest_lazy_fixture import lazy_fixture
<p>@pytest.fixture
def user_a():
return {"id": 1, "name": "Alice"}</p><p>@pytest.fixture
def user_b():
return {"id": 2, "name": "Bob"}</p><p>@pytest.mark.parametrize("user", [lazy_fixture("user_a"), lazy_fixture("user_b")])
def test_user_id(user):
assert isinstance(user, dict)
assert "id" in user</p>⚠️ 注意：不能写成 [user_a, user_b]（这会尝试在装饰器执行时就求值，但此时 fixture 还没运行）；也不能漏掉 lazy_fixture() 包裹。
立即学习“Python免费学习笔记（深入）”；
多个 fixture 组合参数化时怎么写？
支持 tuple、list、dict 形式组合，但每个 fixture 名都得套 lazy_fixture()：
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
-
两两组合（笛卡尔积）：
@pytest.mark.parametrize( "user,db", [(lazy_fixture("user_a"), lazy_fixture("sqlite_db")), (lazy_fixture("user_b"), lazy_fixture("postgres_db"))] ) def test_with_db(user, db): ... -
使用
pytest.param控制 id 或标记：@pytest.mark.parametrize( "user,role", [ pytest.param(lazy_fixture("admin_user"), "admin", id="admin"), pytest.param(lazy_fixture("guest_user"), "guest", id="guest"), ], ) def test_role_access(user, role): ...
容易踩的坑：如果某个 fixture 是 scope="session"，而你在 function 级参数化里混用多个 session fixture，pytest 仍能跑通，但可能掩盖资源复用问题——比如数据库连接被意外共享、状态污染。
为什么不用 lazy-fixture 就不行？
因为 pytest 的参数化发生在收集阶段（collection phase），而 fixture 执行在运行阶段（setup phase）。@pytest.mark.parametrize 的参数列表必须是“静态可求值”的——即装饰器解析时就能确定内容。普通 fixture 名不是值，而是 pytest 内部注册的符号名；lazy_fixture 实际返回一个占位对象，pytest 插件在后续执行时识别它，并触发对应 fixture 的 setup。
性能影响很小，只是加了一层间接调用；但兼容性要注意：某些老版本 pytest（< 7.0）或自定义 hook 可能与 pytest-lazy-fixture 冲突，建议固定用 pytest>=7.2 + pytest-lazy-fixture>=0.6.3。
真正容易被忽略的是：fixture 名拼写错误不会报错，只会变成未定义变量，导致测试函数收到 None 或抛 NameError——但错误堆栈指向测试函数内部，而不是 parametrize 行。务必核对 fixture 名大小写和拼写。
