🐸 青蛙编程网

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 一套打完 ✅ 已上线

适合谁看

  • 已学完 Python 基础 和 面向对象(Pydantic 模型要用类)
  • 学过 Flask 更好——很多概念一一对应,本章会反复对照
  • 想做前后端分离项目的后端、想给 AI 模型套一层服务接口

FastAPI vs Flask 怎么选

对比项 Flask FastAPI
定位 轻量经典,网页 + API 都能写 现代专用,主打 API
参数校验 手动检查 类型注解自动校验
接口文档 要自己写 /docs 自动生成交互文档
异步支持 需要额外配置 原生 async/await
学习曲线 极平缓 平缓(会类型注解即可)

不用二选一:Flask 适合小网站和传统页面渲染,FastAPI 适合纯 API 与高性能场景。会一个,另一个半天就能上手。

记忆口诀

一个路由一个函数,类型注解自动管;/docs 里面点一点,接口文档全生完。

动手建议

  1. 每章都在 venv 里真实跑一遍 uvicorn main:app --reload,边改边看自动重启
  2. 每章都打开 http://127.0.0.1:8000/docs 点一点——这是 FastAPI 最大的快乐
  3. 学完综合练习后,去 Postman 教程把你自己写的 API 正式验收一遍

前置:Python 基础 · 面向对象 · 建议 Flask 🐸