Python异步中yieldfrom用法详解

本文深入剖析了Python异步编程中`yield from`的历史角色与现实局限：它早已被彻底移除出异步语法体系——在`async def`函数中使用会直接触发语法错误，旧式`@asyncio.coroutine`装饰器协程也已在Python 3.11中完全淘汰；`yield from`本质是同步生成器的委托机制，无法驱动协程调度，而`await`才是唯一合法、语义明确且类型安全的异步等待操作符；迁移代码时不仅需机械替换语法，更需警惕调用链中残留的未`await`协程、返回值处理差异及第三方库兼容性陷阱——稍有疏忽，程序便会在静默中失效。

yield from 在 Python 异步编程中早已失效

Python 3.5+ 中，yield from 不再是合法的异步协程语法——它只适用于生成器委托，不能替代 await。如果你在 async def 函数里写 yield from some_coro()，会直接报 SyntaxError: 'yield from' inside async function。这不是写法问题，是语言层面禁止的。

旧版基于 yield from 的协程（@asyncio.coroutine）已弃用

Python 3.4 用 @asyncio.coroutine 装饰普通生成器函数，靠 yield from 驱动子协程，例如：

@asyncio.coroutine
def old_style():
    result = yield from asyncio.sleep(1, result='done')
    return result

这种写法在 Python 3.11 已彻底移除，3.8 起就发 DeprecationWarning。现在调用它会触发 RuntimeWarning: coroutine 'old_style' was never awaited，且无法被 asyncio.run() 正确调度。

• yield from 本身不创建协程对象，只是生成器语法糖；await 才明确要求右侧是 Awaitable
• 旧式协程返回的是 generator 对象，现代协程返回 coroutine 对象，二者不可混用
• asyncio.create_task() 只接受 coroutine，传旧式生成器会报 TypeError: a coroutine was expected, got generator

await 和 yield from 的语义与限制完全不同

await 是专用异步等待操作符，强制要求被等待对象实现 __await__ 方法；yield from 是同步生成器的委托机制，哪怕你把它套在协程上调用（如 yield from asyncio.sleep(1)），也只是把协程对象当普通可迭代对象“展开”，根本不会触发调度。

• await asyncio.sleep(1) → 进入事件循环等待，释放控制权
• yield from asyncio.sleep(1) → 报错（语法不允许），或在非 async 函数中运行 → 返回一个未执行的协程对象，不 await 就等于没调用
• await 支持 AsyncIterator、Task、Future 等多种 awaitable；yield from 只支持实现了 __iter__ 或 __getitem__ 的同步可迭代对象

迁移旧代码时最常踩的坑

把 @asyncio.coroutine + yield from 直接改成 async def + await 看似简单，但有三个隐性雷区：

• 旧代码里可能混用了 yield from asyncio.wait(...)，新写法必须改为 await asyncio.wait(...)，而 asyncio.wait() 返回的是 (done, pending) 元组，不是单个结果
• 旧式协程中用 return value 会变成 StopIteration(value)，现代协程中 return value 是正常返回，但调用方必须用 await 接收，不能用 next() 或 send()
• 第三方库若仍返回旧式生成器协程（比如某些老版本 aiohttp 或 aioredis），需升级或加一层包装：await asyncio.ensure_future(old_coro())

真正难的不是语法替换，而是确认整个调用链是否已全量切换为现代协程——只要有一处漏掉 await，就会让协程对象悬空，表面无错，实则逻辑不执行。

本篇关于《Python异步中yieldfrom用法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！