SuperAPI AI 工具集

python-patterns

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:这是一份 Python 开发原则与决策技能,用于在 2025 年做 Python 架构决策、框架选型、异步模式设计与项目结构规划时提供判断依据。核心思路是教思考方法,而不是提供固定代码复制。使用前若框架偏好不明确,应先询问用户;异步与同步的选择需结合具体语境,不要默认沿用同一框架。

主要能力:一、框架选型决策树:API 优先或微服务选 FastAPI;全栈 Web、CMS 或后台选 Django;简单脚本或学习选 Flask;AI/ML API 服务选 FastAPI(Pydantic、异步、uvicorn);后台任务用 Celery 搭配任意框架。选型时应确认是否纯 API、是否需要后台管理界面、团队是否熟悉异步、现有基础设施情况。二、异步与同步取舍:I/O 密集型(数据库、HTTP、文件)、高并发连接、实时功能、微服务通信、FastAPI/Starlette/Django ASGI 适合 async def;CPU 密集、简单脚本、遗留代码库、团队不熟异步、只有阻塞库时适合同步。原则是 I/O 密集用异步,CPU 密集用同步加多进程,避免混用同步库与异步代码。异步库可参考 httpx、asyncpg、redis-py 异步、aiofiles、SQLAlchemy 2.0 async、Tortoise。三、类型注解策略:函数参数、返回类型、类属性、公开 API 建议始终标注;局部变量、一次性脚本、测试通常可省略。可用 Optional、联合类型、泛型集合、Callable 等模式;API 请求响应模型、配置、数据校验、序列化适合用 Pydantic。四、项目结构:脚本、中型 API、大型应用分不同结构;FastAPI 可按层或按功能组织。五、Django 2025 原则涉及异步视图、异步中间件、有限异步 ORM 与 ASGI 部署,以及模型、视图、查询优化实践,如 select_related、prefetch_related、避免 N+1。六、FastAPI 原则涉及 async def 与 def 的选择、依赖注入、Pydantic v2 集成。七、后台任务工具选择:BackgroundTasks、Celery、ARQ、RQ、Dramatiq 各自适用场景。八、错误处理与测试原则,包括自定义异常、统一错误格式、pytest、httpx/TestClient、pytest-asyncio。九、决策清单与反模式。

限制:该技能仅在任务明确符合上述范围时使用;输出不能替代针对具体环境的验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。