FastAPI 教程
FastAPI 是当下最流行的现代 Python Web 框架——用类型注解写接口,参数自动校验、文档自动生成,性能拉满。如果说 Flask 教你「把代码变成网站」,FastAPI 教你「把代码变成专业级 API」。
前面学过 Flask,知道了一个网址一个函数。本章继续往后端深挖:真实的现代后端大多是「前后端分离」架构,后端专心吐 JSON 接口——这正是 FastAPI 的主场,也是 AI 服务(给大模型套壳)的标准写法。
章节目录
| 章节 | 内容 | 核心知识点 | 状态 |
|---|---|---|---|
| 1. FastAPI 是什么 | 现代 API 框架 | 与 Flask 的分工、三大特性、用在哪 | ✅ 已上线 |
| 2. 第一个应用 | 4 行代码起服务 | pip install、uvicorn --reload、/docs 交互文档 |
✅ 已上线 |
| 3. 路由与参数 | 路径参数、查询参数 | 类型注解自动转换、422 校验、async def |
✅ 已上线 |
| 4. 请求体与 Pydantic | POST 收 JSON | BaseModel、字段校验、在 /docs 里直接试 |
✅ 已上线 |
| 5. 响应与错误处理 | 状态码与报错 | status_code、HTTPException、response_model |
✅ 已上线 |
| 6. 数据库入门 | 让数据住下来 | SQLite + sqlite3、参数化查询、CRUD 路由 |
✅ 已上线 |
| 7. 综合练习 | 迷你待办 API | 全章串联:GET/POST/PUT/DELETE 一套打完 | ✅ 已上线 |
适合谁看
FastAPI vs Flask 怎么选
| 对比项 | Flask | FastAPI |
|---|---|---|
| 定位 | 轻量经典,网页 + API 都能写 | 现代专用,主打 API |
| 参数校验 | 手动检查 | 类型注解自动校验 |
| 接口文档 | 要自己写 | /docs 自动生成交互文档 |
| 异步支持 | 需要额外配置 | 原生 async/await |
| 学习曲线 | 极平缓 | 平缓(会类型注解即可) |
不用二选一:Flask 适合小网站和传统页面渲染,FastAPI 适合纯 API 与高性能场景。会一个,另一个半天就能上手。
记忆口诀
一个路由一个函数,类型注解自动管;
/docs里面点一点,接口文档全生完。
动手建议
- 每章都在 venv 里真实跑一遍
uvicorn main:app --reload,边改边看自动重启 - 每章都打开
http://127.0.0.1:8000/docs点一点——这是 FastAPI 最大的快乐 - 学完综合练习后,去 Postman 教程把你自己写的 API 正式验收一遍