Python异步生成器详解：async与yield结合使用

本文深入剖析了Python中异步生成器（async generator）的核心机制与常见误区：它由`async def`函数内含`yield`定义，本质是惰性、不可重用的`async_generator`对象，既非协程也非同步生成器；必须通过`async for`消费，严禁`await`、`list()`或`next()`调用；强调`yield`仅交出值而不挂起，真正的异步暂停依赖`await`；同时明确其与同步生态完全隔离，无法被普通迭代上下文使用，为开发者厘清了语法边界、使用规范与性能注意事项。

async def 里用 yield 就是异步生成器，不是协程

Python 中 async def 函数返回协程对象，但只要里面用了 yield，它就变成异步生成器（async generator），类型是 async_generator，不是 coroutine。这点容易混淆——很多人以为加了 async 就一定得 await，但异步生成器本身不能直接 await，得用 async for 驱动。

• 错误写法：await async_gen() → 报 TypeError: object async_generator can't be used in 'await' expression
• 正确写法：async for x in async_gen(): ...
• 异步生成器函数调用后立即返回一个 async_generator 对象，不执行任何逻辑，和普通生成器一样“惰性”

async for 是唯一合法的消费方式，别想用 list() 或 next()

async for 是语言层面对异步生成器的专用语法糖，底层调用的是 __aiter__() 和 __anext__()。你没法像同步生成器那样用 list(gen)、next(gen) 或手动调 gen.send()，所有这些都会失败。

• list(async_gen()) → TypeError: 'async_generator' object is not iterable
• next(async_gen()) → TypeError: 'async_generator' object is not an iterator
• 想转成列表？必须显式收集：items = [item async for item in async_gen()]
• 注意：async for 会自动处理 StopAsyncIteration，不用 try/except

yield 和 await 可以混用，但 yield 不挂起，await 才挂起

在异步生成器内部，yield 本身不触发暂停，它只是把值交出去并让出控制权；真正可能挂起的是 await 表达式（比如 await asyncio.sleep(1)）。每次 async for 拿到一个值后，函数从上次 yield 处继续往下跑，直到下一个 yield 或函数结束。

• 常见误判：以为 yield x 会等 IO，其实不会；IO 挂起靠的是 await
• 典型场景：边请求 API 边 yield 解析结果：data = await fetch(); yield parse(data)
• 参数差异：异步生成器函数可以接收普通参数或 **kwargs，但不能带 return value（只能 return，且无值）
• 性能提示：频繁 yield 小数据 + 高频 await 可能放大事件循环调度开销，不如批量攒一批再 yield

异步生成器不能被同步代码消费，兼容性边界很硬

异步生成器对象没有 __iter__ 或 __next__，所以任何期望同步迭代的上下文（比如普通 for、itertools.chain、pandas 的 concat）都完全无法接入。这不是设计缺陷，而是明确的语义隔离——它只属于 async 上下文。

• 错误尝试：for x in async_gen(): ... → TypeError: 'async_generator' object is not iterable
• 没捷径：不能用 asyncio.run() 包一层来“转成同步”，因为 async for 必须在协程函数内
• 如果要桥接，只能在外层协程里收集成列表，再传给同步代码：sync_list = await collect_async_gen()
• 容易忽略的一点：异步生成器一旦被 async for 消费过一次，就不可重用，和普通生成器一样

理论要掌握，实操不能落！以上关于《Python异步生成器详解：async与yield结合使用》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！