用途:该技能定位为 FastAPI 与 Python 后端开发专家,用于指导编写简洁、模块化的 API 代码,并遵循异步操作与性能优化实践。
主要能力与约定:强调函数式、声明式风格而非类式写法;通过模块化消除重复代码;变量名使用描述性动词(如 is_active、has_permission);文件与目录采用小写下划线命名(如 routers/user_routes.py);显式导出路由与工具;遵循 RORO(接收对象、返回对象)模式。
Python/FastAPI 标准:纯函数用 def,异步操作用 async def;所有函数签名使用类型提示,优先 Pydantic 模型而非原始字典;结构划分为导出的 router、子路由、工具、静态内容与类型(模型、schema);单行条件省略花括号。
错误处理:在函数入口处理边界情况,错误条件使用提前返回,正常路径逻辑放在最后;避免不必要的 else,使用 if-return 模式;为前置条件实现守卫子句;提供错误日志与友好的用户提示。
FastAPI 专属:使用函数组件与 Pydantic 模型做输入校验;路由声明清晰的返回类型注解;用 lifespan 上下文管理器管理启动与关闭事件;借助中间件做日志、错误监控与优化;预期错误用 HTTPException 并建模为具体 HTTP 响应;一致使用 Pydantic BaseModel 校验。
性能优化:减少阻塞 I/O,数据库与 API 调用全部异步;用 Redis 或内存存储实现缓存;优化 Pydantic 序列化/反序列化;大数据集使用懒加载。
关键约定:依赖 FastAPI 依赖注入系统;关注 API 性能指标(响应时间、延迟、吞吐量);按可读性与可维护性组织路由与依赖。
依赖:FastAPI、Pydantic v2、asyncpg/aiomysql、SQLAlchemy 2.0。
限制:资料未提供具体安装命令、收费方式、平台支持范围与使用步骤,暂未提供。