用途:帮助开发者在 Python 架构决策中做选择,包括选定框架、设计异步模式、规划类型提示与项目结构。定位是教学“如何思考”,而非提供可复制的固定代码。
主要能力: 一、框架选型。按构建目标区分:API 优先/微服务倾向 FastAPI,全栈/CMS/后台常用 Django,简单脚本或学习用 Flask,AI/ML 接口服务常配 FastAPI + Pydantic + uvicorn,后台任务用 Celery 搭配任意框架;并提示向用户确认框架偏好,避免每次都默认同一框架。 二、异步决策。I/O 密集(数据库、HTTP、文件)、高并发、实时特性、微服务通信适合 async;CPU 密集、简单脚本、遗留代码、团队不熟异步或缺少异步库时用同步。注意不要混用同步与异步、不要在异步代码中使用同步库。列出常见异步库:httpx、asyncpg、aioredis/redis-py async、aiofiles、SQLAlchemy 2.0 async 或 Tortoise。 三、类型提示。函数参数、返回值、类属性、公开 API 应加类型;局部变量、一次性脚本、测试通常可省略。涵盖 Optional、Union、泛型集合、Callable 等写法,并说明 Pydantic 适用于请求/响应模型、配置、数据校验与序列化。 四、项目结构。按小脚本、中型 API、大型应用给出目录分层,并介绍 FastAPI 按层或按功能组织。 五、还涉及 Django 5.0+ 异步能力与查询优化(select_related、prefetch_related、避免 N+1)、FastAPI 依赖注入与 Pydantic v2 集成、后台任务方案选择(BackgroundTasks、Celery、ARQ、RQ、Dramatiq)、错误处理与统一错误响应、测试策略(pytest、httpx、pytest-asyncio、fixtures)、决策清单与反模式。
使用方式:作为决策参考,按“决策清单”逐项确认框架偏好、异步需求、类型策略、结构、错误处理与后台任务,理解示例模式后结合自身上下文选择。
限制:资料为原则性指导,未提供安装命令、版本要求、性能基准或收费信息;具体实现细节与最新变更需自行核实。