await 等待的是可等待对象(如协程、Task、Future 或实现__await__的对象)完成并返回结果,由事件循环驱动,不阻塞线程,返回协程的return值或冒泡异常。

await 等的是一个协程对象(coroutine object)完成执行并返回结果,而不是“等时间”或“等线程”。它本质上是在等待一个可等待对象(awaitable)——比如协程、Task、Future 或实现了 __await__ 方法的对象——进入完成状态,并获取其返回值。
await 的目标必须是 awaitable
不是所有对象都能跟在 await 后面。Python 会检查该对象是否为 awaitable:
- 是协程函数(
async def定义的函数)调用后的返回值(即协程对象); - 是
asyncio.Task或asyncio.Future实例; - 是定义了
__await__方法且返回迭代器的对象(如某些第三方库自定义的 awaitable)。
常见错误:直接 await time.sleep(1) 会报错,因为 time.sleep 是同步阻塞函数,返回 None,不是 awaitable。正确写法是 await asyncio.sleep(1)。
await 不会自己运行协程,需要事件循环驱动
await 本身不启动任何并发;它只是把当前协程的控制权交还给事件循环,让事件循环去调度其他任务。真正执行协程的是事件循环(如 asyncio.run() 启动的那个)。
立即学习“Python免费学习笔记(深入)”;
随缘网络PHP企业网站管理系统V2.0正式发布,该企业网站管理系统采用PHP+MYSQL编写,界面色调风格延续之前1.0版管理系统简洁浅蓝色风格,稍有所变动。变更分类树形目录方式采用jquery库,产品,文章三级无限分类。希望大家能够喜欢。系统中难免有些小问题,希望大家在使用中有什么问题可到本站论坛提出,我们将总结各问题后给予修正并升级。本站再次声明对于免费版系列系统本站不提供QQ电话等技术咨询服
- 遇到
await时,当前协程暂停,但线程没被阻塞; - 事件循环趁此机会去跑别的就绪协程(比如另一个
await已完成的任务); - 当被 await 的对象就绪(例如网络响应到达、定时器到期),事件循环恢复该协程,
await表达式才得到返回值。
await 的返回值就是协程的 return 值
就像普通函数调用得到 return 的值,await 得到的是被等待协程执行完毕后 return 的内容:
async def fetch_data():
await asyncio.sleep(1)
return {"status": "ok", "data": 42}
result = await fetch_data() # result 就是 {"status": "ok", "data": 42}
如果协程没写 return,默认返回 None;如果协程抛出异常,await 会直接把异常冒泡出来。
别把 await 和多线程/多进程混淆
await 是单线程内的协作式并发机制。它不创建新线程,也不分配 CPU 核心。IO 密集型场景下高效,是因为它避免了线程切换开销和资源占用;但 CPU 密集型任务仍需用 loop.run_in_executor 或 concurrent.futures 配合线程/进程池。
-
await asyncio.sleep()→ 让出控制权,不占 CPU; -
time.sleep()→ 真正阻塞线程,整个事件循环卡住; -
await asyncio.to_thread(cpu_heavy_func)→ 把 CPU 工作扔进线程池,避免阻塞事件循环。









