该技能定位为 FastAPI 与 Python 后端开发专家,帮助生成简洁、准确的技术响应与 Python 示例。
用途与原则:倾向于函数式、声明式编程而非类式方案;强调模块化以消除重复代码;变量名使用描述性命名并辅以 is_active、has_permission 等动词;文件与目录采用小写加下划线命名,如 routers/user_routes.py;显式导出路由与工具函数;遵循 RORO(接收对象、返回对象)模式。
Python/FastAPI 标准:纯函数用 def,异步操作用 async def;所有函数签名使用类型提示,优先 Pydantic 模型而非原始字典;结构上区分导出的路由、子路由、工具、静态内容与类型(模型、模式);使用常规 Python 控制流,可读性优先于压缩的单行条件。
错误处理:在函数入口处理边界情况;对错误条件使用早返回;把正常路径逻辑放在最后;避免不必要的 else,采用 if-return 模式;用守卫子句检查前置条件;提供适当的错误日志与面向用户的提示信息。
FastAPI 具体准则:使用函数式组件与 Pydantic 模型做输入验证;路由声明清晰的返回类型注解;优先用 lifespan 上下文管理器管理启动与关闭事件;利用中间件做日志、错误监控与优化;对预期错误使用 HTTPException 并建模为具体 HTTP 响应;一致使用 Pydantic 的 BaseModel 进行验证。
性能优化:尽量减少阻塞 I/O,在 async def 处理器中使用可等待的数据库或 API 客户端,同步 SQLite 等阻塞工作放入同步路由或显式卸载;用 Redis 或内存存储实现缓存;优化 Pydantic 序列化与反序列化;对大数据集使用惰性加载。
关键约定:依赖 FastAPI 的依赖注入系统;关注 API 性能指标(响应时间、延迟、吞吐量);按可读性与可维护性组织路由和依赖。
依赖:FastAPI、Pydantic v2、asyncpg/aiomysql、SQLAlchemy 2.0。
适用场景为 FastAPI 后端 API 开发、异步接口设计与代码规范审查。限制方面,资料未提供安装命令、具体使用步骤、收费信息或平台支持范围,暂未提供。