最常见的错误是调用async函数未加await导致协程对象未执行；await只能在async函数内使用；混用同步阻塞操作会卡住事件循环；需用async with管理资源并妥善处理取消；create_task()后须保存task引用以避免丢失。
忘记 await 导致协程对象未执行
最常见的错误是调用一个 async def 定义的函数却没加 await，结果得到一个协程对象（<coroutine object ... at 0x...>），但什么也没运行。Python 不会报错，只是静默返回协程，后续如果尝试打印或参与计算，容易引发 TypeError 或逻辑错误。
- 错误写法：
result = my_coro()——result是协程对象，不是返回值 - 正确写法：
result = await my_coro()（在 async 函数内）或result = asyncio.run(my_coro())（在顶层） - 调试提示：打印变量类型，若为
coroutine就要检查是否漏了 await
在非异步上下文中调用 await
await 只能在 async def 函数内部使用。直接在普通函数、模块顶层或同步回调中写 await，会触发 SyntaxError: 'await' outside async function。
- 错误写法：
def handler(): return await fetch_data() - 解决方式：要么把外层函数改为 async def，要么用
asyncio.run()启动协程（仅限程序入口，不可嵌套多次调用） - 注意：
asyncio.run()每次调用都会新建事件循环，不能在已有循环中重复调用（如已处于asyncio.run()内部时再调）
混用同步阻塞操作破坏异步性能
在协程中直接调用 time.sleep()、requests.get()、文件读写（open().read()）等同步阻塞操作，会导致整个事件循环卡住，其他任务无法调度，失去异步意义。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 替代方案：
await asyncio.sleep()替代time.sleep() - HTTP 请求：改用
aiohttp、httpx.AsyncClient等异步库 - 文件 I/O：用
asyncio.to_thread()（Python 3.9+）包裹同步操作，或使用aiofiles - 数据库：选用异步驱动，如
asyncpg、aiomysql、motor（MongoDB）
错误处理协程生命周期与资源泄漏
协程被取消（如超时、用户中断）时，若未妥善清理资源（如打开的连接、临时文件），容易导致泄漏。常见误区包括忽略 async with、不捕获 CancelledError、或在 finally 中执行阻塞操作。
立即学习“Python免费学习笔记（深入）”；
- 始终优先用
async with管理异步上下文（如aiohttp.ClientSession、asyncpg.Pool） - 避免在
finally块中写await—— 若协程已被取消，再次 await 可能抛出CancelledError；可改用asyncio.shield()保护关键清理步骤 - 显式处理取消：捕获
asyncio.CancelledError并做必要释放（注意不要吞掉它，除非你确定要压制） - 超时控制统一用
asyncio.wait_for(coro, timeout)，而非手动记录时间 + 循环检查
误用 asyncio.create_task() 与任务管理不当
create_task() 立即调度协程，但若未保存引用或未等待完成，任务可能在被调度前就被垃圾回收，尤其在短生命周期协程中易丢失结果或引发未预期退出。
- 不要只写
asyncio.create_task(some_coro())就丢弃返回值 —— 任务可能被取消或异常而无人知晓 - 推荐做法：保存 task 对象，用
await task获取结果，或用asyncio.gather()/asyncio.wait()统一管理 - 后台任务需确保存活：将 task 存入集合（如
set()）并配合asyncio.current_task()或asyncio.all_tasks()监控 - 注意：
asyncio.ensure_future()已不推荐，优先用create_task()
