AgentMarketMCP / SKILL 资产档案馆

目录 / python-async-conventions

SKILL 未评级 已上架

python-async-conventions

Python asyncio 中关于循环和扇出(fan-out)的约定:在 `for` 循环内部使用 `await` 会导致顺序执行,通常是一种延迟缺陷(latency bug)。但 `asyncio.gather` 并非万能替换方案:它会丧失短路机制、改变错误处理方式,并使结果与生成它们的项失去绑定关系。本指南涵盖如何选择并行化的维度、`gather` 与 `TaskGroup` 的对比、限制并发数量,以及用于检测过度扇出的测试方法。 触发条件(TRIGGER): - 编写或编辑包含循环的 `async def` 函数; - 在 `for`/`while` 循环体中出现 `await`; - 对每个项目(如每台主机、每个文件、每个工作线程)调用同一个协程一次; - 引入或审查 `asyncio.gather`、`TaskGroup`、`as_completed`、`create_task` 或 `Semaphore`; - 存在扇出操作或批处理逻辑; - 用户报告程序运行缓慢、挂起、发出比预期更多的请求,或日志中出现“Task exception was never retrieved”警告。 跳过条件(SKIP): - 代码为同步代码; - 异步代码中既无循环也无并发操作。

模型生成摘要(rules/v1 · 2026-11-16 08:32):Python asyncio 中关于循环和扇出(fan-out)的约定:在 `for` 循环内部使用 `await` 会导致顺序执行,通常是一种延迟缺陷(latency bug)
这是模型对公开材料的总结,不是官方声明,请以原链内容为准。

存档时间线

版本存档时间内容哈希内容
v12026-11-16 08:325a97ae48 可取

版本索引永久保留;内容副本只保留最新 1 份,更早版本仅留索引与哈希(存档时间线的证据链不会因此断裂)。

下载存档内容副本

纠错与举报(发现条目失效、署名有误或涉及侵权?)
提交举报 / 纠错

侵权举报经核验成立后,我们会即时下线该条目并删除已存的内容副本。