fixture名不可用test_开头,否则pytest误判为测试函数;scope决定复用范围:function(默认,每函数重建)、class(类内共享)、module(模块级)、session(全局单例);yield比return更安全,确保teardown执行。

fixture 名字别用 test_ 开头
pytest 会把所有以 test_ 开头的函数当成测试用例,哪怕你加了 @pytest.fixture 装饰器,它也不会被识别为 fixture,反而可能报 FixtureNotFound 或直接跳过加载。正确做法是让 fixture 函数名语义清晰、不带测试前缀,比如 mock_api_client、tmp_db_path,而不是 test_db_connection。
scope 参数决定复用范围和生命周期
fixture 的 scope 不只是“快慢”问题,它直接影响状态是否共享、资源是否重复初始化。常见取值和适用场景:
-
scope="function"(默认):每个测试函数运行前创建、结束后销毁,适合有副作用的操作,比如临时文件、mock 对象 -
scope="class":整个测试类共用一个实例,适合类内多个测试需共享同一数据库连接或服务实例 -
scope="module":模块级复用,适合初始化开销大的资源(如启动轻量 HTTP server),但要注意避免测试间状态污染 -
scope="session":整个 pytest 运行周期只执行一次,常用于全局配置加载或一次性服务启动;必须确保它是真正无状态或线程安全的
错误示例:@pytest.fixture(scope="session") 返回一个修改了内部状态的 sqlite3.Connection,后续测试可能读到脏数据。
yield 比 return 更安全地管理清理逻辑
用 yield 替代 return 是写可复用 fixture 的关键习惯——它天然支持“前置 setup + 后置 teardown”,且即使测试崩溃也能保证清理代码执行。
比如创建临时目录:
@pytest.fixture
def tmp_dir():
d = Path(tempfile.mkdtemp())
yield d
shutil.rmtree(d, ignore_errors=True)
如果改用 return d,测试中途抛异常时目录不会被删除,容易堆积垃圾;而 yield 后的代码在任何退出路径下都会执行。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
注意点:
- yield 后不要跟值(即不要写
yield x后再操作x),因为那部分在 fixture 被消费后才执行 - 避免在 yield 后做耗时或可能失败的操作(如网络请求),否则会影响测试退出速度
- 若需传递多个对象,用元组或命名空间封装,而非依赖 yield 多次产出
参数化 fixture 要小心参数组合爆炸
用 params 参数可以驱动 fixture 生成不同变体,但容易误用导致测试数量指数增长。例如:
@pytest.fixture(params=["sqlite", "postgresql"])
def db_engine(request):
return create_engine(request.param)
如果这个 fixture 被 5 个测试函数使用,就会变成 10 个测试用例;若再叠加另一个 3 值参数化 fixture,就变成 30 个——很多是冗余覆盖。
更可控的做法:
- 只对核心差异路径参数化(比如只测 sqlite,postgresql 留给集成测试阶段)
- 用
ids参数让输出名可读,避免db_engine[sqlite]这种模糊标识 - 避免跨 fixture 参数耦合,比如一个 fixture 依赖另一个参数化 fixture 时,没控制好会隐式放大参数规模
真正难的不是写出来,而是判断某个 fixture 是否该参数化、参数边界划在哪——这得看你的验证目标,而不是“看起来更全”。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










