Python协程入门教程_asyncawait语法解析

Python协程是单线程内由解释器通过async/await主动挂起与恢复的高并发I/O机制，需用await或asyncio.run()启动，await仅适用于协程对象、Task或Future，且必须在async函数中使用。

Python协程不是线程，也不靠操作系统调度，而是由解释器在单线程内通过 async 和 await 主动挂起与恢复函数执行，实现高并发 I/O 操作。掌握它，关键不是理解“多任务”，而是搞清“控制流何时让出、何时回来”。

async def 定义的是协程函数，不是立即执行的普通函数

写 async def fetch_data(): ... 只是定义了一个协程对象生成器，调用它不会运行函数体，而是返回一个 coroutine 对象：

• 直接调用 fetch_data() → 返回 ，什么都没发生
• 必须用 await fetch_data()（在另一个协程里）或 asyncio.run(fetch_data()) 才真正启动执行
• 普通函数里不能写 await，会报 SyntaxError: 'await' outside async function

await 只能出现在 async 函数中，且只能等待“可等待对象”

await 不是万能等待关键字，它要求右边的表达式必须是以下三类之一：

• 另一个协程对象（比如 await another_async_func()）
• asyncio.Task（用 asyncio.create_task() 包装后的并发任务）
• asyncio.Future（底层异步结果占位符，一般不手动创建）
• 常见错误：对普通函数、列表、字符串、time.sleep() 写 await → 报 TypeError: object xxx can't be used in 'await' expression

asyncio.run() 是最简入口，但别在库代码里用

脚本顶层想跑协程，用 asyncio.run(main()) 最直接：

import asyncio
async def main():
print("start")
await asyncio.sleep(1)
print("done")
asyncio.run(main())  # 输出 start → 等1秒 → done

• 它会自动创建事件循环、运行协程、关闭循环，适合脚本和测试
• 但一个程序只能调用一次 asyncio.run()；重复调用会报 RuntimeError: asyncio.run() cannot be called from a running event loop
• 写模块或框架时，应把协程交给上层事件循环管理，不要自己 run()

用 await 模拟“暂停”，不是线程 sleep

await asyncio.sleep(1) 看似像 time.sleep(1)，但本质完全不同：

• time.sleep(1)：阻塞整个线程，期间其他协程也无法运行
• asyncio.sleep(1)：挂起当前协程，把控制权交还事件循环，其他协程可继续执行
• 所以多个 await asyncio.sleep(1) 并发运行，总耗时约 1 秒；而多个 time.sleep(1) 串行则要 3 秒

协程不是魔法，它依赖你主动用 await 让出控制权，并选择支持异步的库（如 aiohttp 替代 requests，aiomysql 替代 pymysql）。写对 async/await 语法只是第一步，真正发挥价值得配合异步生态一起用。