asyncio.wait的timeout参数控制整个wait调用的最大等待时间，超时后未完成任务保留在pending中且不会自动取消；需手动cancel并await清理。
asyncio.wait 的 timeout 参数到底控制什么？
asyncio.wait 的 timeout 参数不是给每个任务单独设超时，而是限制整个 wait 调用的最长等待时间。一旦超时，未完成的任务仍处于 pending 状态，不会被取消——这点常被误认为“任务超时被杀掉了”。
- 如果你期望某个任务在 3 秒内必须结束，
timeout=3不够，得配合asyncio.wait_for或手动cancel() -
timeout更适合“我最多等 3 秒，看看此刻有哪些已结束” - 返回值是两个
set：done 和 pending，需主动检查 pending 里有没有你关心的任务
如何让单个任务真正超时并取消？
要实现“任务运行超 5 秒就强制终止”，不能只靠 asyncio.wait(timeout=5)，得组合使用：
- 用
asyncio.create_task()显式创建任务（避免直接传协程对象） - 在
wait后检查 pending 集合，对其中目标任务调用task.cancel() - 推荐更简洁的做法：对单个任务用
asyncio.wait_for(task, timeout=5)，它会在超时后自动 cancel 并抛出asyncio.TimeoutError
try:
result = await asyncio.wait_for(my_task, timeout=5)
except asyncio.TimeoutError:
print("my_task 超时被取消")
wait 与 gather 在超时控制上的关键区别
asyncio.gather 默认不支持全局 timeout；加 return_exceptions=True 后也只吞异常，不取消 pending 任务。
-
gather(..., return_exceptions=True)：超时未处理，所有任务照常跑，除非你额外包装 -
wait(..., timeout=...)：返回 pending 集合，给你取消的主动权 -
wait_for：专为单任务超时设计，语义清晰，推荐优先用于明确的单任务时限场景
容易忽略的 pending 任务清理问题
pending 里的任务如果不再 await、也不 cancel，会一直挂起，占用事件循环资源，甚至导致内存泄漏。
- 每次用
wait后，若存在 pending 任务，应显式task.cancel()并 await 它（或用asyncio.shield保护关键清理逻辑） - 不要假设“不 await pending 就没事”——它们仍在调度队列中，可能在后续某次 loop.run_until_complete 时意外执行
- 特别注意：任务 cancel 后需 await 才能确保其 cleanup 逻辑（如
<strong>aexit</strong>）运行
超时控制不是设个参数就完事，关键是理解 done/pending 的生命周期，以及 cancel 后是否真正 await 了那个 task。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
