---

name: async-python-patterns description: "使用 asyncio、并发编程模式和 async/await 实现异步 Python 应用的全面指南，用于构建高性能非阻塞系统。" risk: safe source: community date_added: "2026-02-27"

异步 Python 模式

使用 asyncio、并发编程模式和 async/await 实现异步 Python 应用的全面指南，用于构建高性能非阻塞系统。

何时使用此技能

• 构建异步 Web API（FastAPI、aiohttp、Sanic）
• 实现并发 I/O 操作（数据库、文件、网络）
• 创建带并发请求的网络爬虫
• 开发实时应用（WebSocket 服务器、聊天系统）
• 同时处理多个独立任务
• 构建带异步通信的微服务
• 优化 I/O 密集型工作负载
• 实现异步后台任务和队列

不要使用此技能当

• 工作负载是 CPU 密集型且 I/O 极少时。
• 简单的同步脚本就足够时。
• 运行时环境不支持 asyncio/事件循环时。

指导说明

• 明确工作负载特征（I/O vs CPU）、目标和运行时约束。
• 选择并发模式（tasks、gather、queues、pools）及取消规则。
• 添加超时、背压和结构化错误处理。
• 包含异步代码路径的测试和调试指导。
• 如需详细示例，请打开 resources/implementation-playbook.md。

参考 resources/implementation-playbook.md 获取详细模式和示例。

资源

• resources/implementation-playbook.md 获取详细模式和示例。

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请停下来要求澄清。