asyncio — 异步 I/O

---

你好，世界！

import asyncio

async def main():
    print('Hello ...')
    await asyncio.sleep(1)
    print('... World!')

asyncio.run(main())

asyncio 是一个使用 async/await 语法编写并发代码的库。

asyncio 被用作多个 Python 异步框架的基础，这些框架提供高性能的网络和 Web 服务器、数据库连接库、分布式任务队列等。

asyncio 通常非常适合 IO 密集型和高层结构化网络代码。

asyncio 提供了一组高层 API，用于：

• 并发运行 Python 协程，并完全控制它们的执行；

• 执行 网络 IO 和 IPC；

• 控制子进程；

• 通过队列分发任务；

• 同步并发代码；

此外，还有供*库和框架开发人员*使用的底层 API，用于：

• 创建和管理事件循环，它为网络、运行子进程、处理操作系统信号等提供异步 API；

• 使用传输实现高效的协议；

• 用 async/await 语法桥接基于回调的库和代码。

可用性：非 WASI。

此模块在 WebAssembly 上不起作用或不可用。有关详细信息，请参阅WebAssembly 平台。

asyncio REPL

你可以在REPL中尝试 asyncio 并发环境

$ python -m asyncio
asyncio REPL ...
Use "await" directly instead of "asyncio.run()".
Type "help", "copyright", "credits" or "license" for more information.
>>> import asyncio
>>> await asyncio.sleep(10, result='hello')
'hello'

引发一个没有参数的审计事件 cpython.run_stdin。

在 3.12.5 版本中更改：（以及 3.11.10、3.10.15、3.9.20 和 3.8.20）发出审计事件。

在 3.13 版本中更改：如果可能，则使用 PyREPL，在这种情况下，也会执行 PYTHONSTARTUP。发出审计事件。

参考

高层 API

• 运行器
• 协程和任务
• 流
• 同步原语
• 子进程
• 队列
• 异常

底层 API

• 事件循环
• Future
• 传输和协议
• 策略
• 平台支持
• 扩展

指南和教程

• 高层 API 索引
• 底层 API 索引
• 使用 asyncio 开发

注意

asyncio 的源代码可以在 Lib/asyncio/ 中找到。