📖 资源简介
最近有朋友问【马士兵教育】速度最快的异步框架FastAPI – 带源码课件的学习资料，正好手头有一套比较完整的，就整理出来分享给大家。
✨ 资源亮点
- 内容扎实：37节视频课程，跟着老师一步步操作，比自学摸索快得多。
- 带源码课件：不是纯视频录像，配套的源代码和PPT都在，方便对照学习和二次修改。
📚 课程内容
课程大纲
- 注意：部分视频含有水印，切勿相信
资源清单
| 类型 | 数量 |
|---|---|
| 视频教程 | 37 节 |
| 压缩文件 | 0 个 |
| 其他文件 | 1 个 |
| 合计 | 38 |
这套课程在讲什么
从 37 节标题能看出，这是一条”FastAPI 入门 → SQLAlchemy ORM → 员工管理 CRUD 实战”的完整路径：前 12 节打通 Web 协议、路由、传参；13~31 节深入 SQLAlchemy 与数据库关系映射；32~37 节用 Pydantic Schema、依赖注入、分页查询把一个员工管理接口写完。带源码课件，边看边敲效果最好。
一、为什么是 FastAPI
如果你用过 Flask 或 Django，再上手 FastAPI 会有几个明显感受：
- 自带类型提示：函数签名里写
id: int，框架自动做参数校验、序列化、生成文档。 - 自动 OpenAPI 文档：启动后访问
/docs（Swagger UI）和/redoc，接口文档秒级生成，前后端联调效率翻倍。 - 原生异步：基于
asyncio，IO 密集型接口（调数据库、调第三方 API）性能远超传统同步框架。 - 性能接近 NodeJS/Go：Starlette 作者 benchmarks 里 FastAPI 是 Python 生态最快的 Web 框架之一。
适合人群：已经懂一点 Python 基础、想做后端接口 / 微服务 / AI 应用后端（大模型 API 包装）的开发者。
二、ASGI vs WSGI：为什么它快
这是课程第 1、2 节的核心概念，也是面试高频题。
- WSGI（Web Server Gateway Interface）：Python 2 时代的同步协议，每个请求占一个线程，请求阻塞时线程干等。Flask/Django 传统部署走这个。
- ASGI（Asynchronous Server Gateway Interface）：异步版网关协议，单个事件循环能同时挂起成千上万个 IO 等待中的请求，遇到
await就让出，不等数据库返回就去处理下一个请求。
# 用 uvicorn 启动一个 ASGI 应用
uvicorn main:app --reload --port 8000
# --reload 改代码自动重启，开发用；生产关掉
三、第一个 FastAPI 程序与自动文档
# main.py
from fastapi import FastAPI
app = FastAPI(title="员工管理 API", version="1.0.0")
@app.get("/")
def read_root():
return {"hello": "fastapi"}
@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
return {"item_id": item_id, "q": q}
启动后浏览器打开：
http://127.0.0.1:8000/docs—— Swagger UI，可在线调试接口。http://127.0.0.1:8000/redoc—— ReDoc 风格文档。http://127.0.0.1:8000/openapi.json—— 原始 OpenAPI 规范。
课程第 4 节专门讲”接口文档打开慢的问题”，常见原因是 Swagger CDN 静态资源被墙或内网加载慢，生产环境建议离线化或关闭。
四、三种传参方式：路径 / 查询 / 请求体
这是 FastAPI 最优雅的部分，全部靠类型注解驱动。
from fastapi import FastAPI, Query, Path
from pydantic import BaseModel
app = FastAPI()
class Employee(BaseModel): # Pydantic 模型 = 请求体 Schema
name: str
age: int
email: str | None = None
# 1) 路径参数：出现在 URL 路径里
@app.get("/emp/{emp_id}")
def get_emp(emp_id: int = Path(..., ge=1, le=1000)): # 自动校验 1<=id<=1000
return {"emp_id": emp_id}
# 2) 查询参数：函数参数没在路径里就是查询参数
@app.get("/emps/")
def list_emps(page: int = 1, size: int = Query(10, le=100)):
return {"page": page, "size": size}
# 3) 请求体：传 Pydantic 模型，自动解析 JSON + 校验
@app.post("/emps/")
def create_emp(emp: Employee):
return {"created": emp.name, "age": emp.age}
参数校验失败会自动返回 422，错误信息还是结构化 JSON，不用自己写 if-else。这就是 FastAPI 相比 Flask 的生产力跃升。
五、依赖注入 Depends
课程第 33 节专门讲 session 的依赖注入。这个机制让你把”拿数据库连接””校验当前用户””分页公共参数”这类横切逻辑抽出来复用：
from fastapi import Depends, FastAPI
app = FastAPI()
# 一个依赖：返回数据库 session（伪代码）
def get_db():
db = "session-obj"
try:
yield db # yield 形式支持请求结束后自动清理
finally:
db.close()
# 另一个依赖：当前登录用户
def get_current_user(token: str = Depends(oauth2_scheme)):
return decode_token(token)
@app.get("/me/")
def read_me(user=Depends(get_current_user), db=Depends(get_db)):
return {"user": user, "db": db}
依赖可以嵌套、可以复用、可以在路由级/全局级挂载，是大型 FastAPI 项目解耦的关键。
六、异步 async/await 与并发
把路径函数写成 async def，IO 操作就要用异步版本：
import asyncio
from fastapi import FastAPI
app = FastAPI()
@app.get("/async-demo")
async def async_demo():
# 并发等待两个 IO，总耗时约 1 秒而不是 2 秒
result1, result2 = await asyncio.gather(
asyncio.sleep(1, result="A"),
asyncio.sleep(1, result="B"),
)
return {"r1": result1, "r2": result2}
后台任务用 BackgroundTasks，响应返回后再慢慢跑，不阻塞用户：
from fastapi import BackgroundTasks
def write_log(msg: str):
with open("log.txt", "a") as f:
f.write(msg + "\n")
@app.post("/notify/")
async def notify(tasks: BackgroundTasks):
tasks.add_task(write_log, "user registered")
return {"msg": "ok, 日志后台记录中"}
一个常见误区：async def 里千万别跑同步阻塞库（比如 requests、同步 time.sleep），会把事件循环卡住。要么用异步库（httpx、aiomysql），要么把该路由写成普通 def（FastAPI 会自动把它丢到线程池）。
七、认证、CORS、中间件、静态文件
7.1 OAuth2 + JWT 认证
FastAPI 提供 OAuth2PasswordBearer 脚手架，配合 python-jose 签 JWT：
from fastapi import Depends, FastAPI
from fastapi.security import OAuth2PasswordBearer
oauth2_scheme = OAuth2PasswordBearer(tokenUrl="login")
app = FastAPI()
@app.get("/secure/")
def secure(token: str = Depends(oauth2_scheme)):
return {"token": token}
7.2 CORS 跨域
前后端分离开发必备，否则浏览器会拦跨域请求：
from fastapi.middleware.cors import CORSMiddleware
app.add_middleware(
CORSMiddleware,
allow_origins=["http://localhost:5173"], # 前端地址
allow_credentials=True,
allow_methods=["*"],
allow_headers=["*"],
)
7.3 挂载静态文件
from fastapi.staticfiles import StaticFiles
app.mount("/static", StaticFiles(directory="static"), name="static")
八、SQLAlchemy 与课程 ORM 部分
课程 13~31 节花了近一半篇幅讲 SQLAlchemy，这是工业级项目绕不开的。要点：
create_engine建连接引擎；- 用 declarative base 定义模型类；
alembic做数据库迁移（相当于 Django 的makemigrations/migrate）；Session做增删改查；- 一对多、一对一、多对多关联关系的映射；
- 课程 32~37 节把 ORM 模型和 Pydantic Schema 做转换，加依赖注入、分页查询、修改删除，完整走一遍员工管理接口。
这部分建议跟着源码课件一行行敲，SQLAlchemy 的 relationship 配置是新手重灾区。
九、测试与部署
9.1 TestClient 写测试
from fastapi.testclient import TestClient
from main import app
client = TestClient(app)
def test_read_root():
r = client.get("/")
assert r.status_code == 200
assert r.json() == {"hello": "fastapi"}
9.2 生产部署
# 开发：uvicorn 直接跑
uvicorn main:app --reload
# 生产：gunicorn 管理多进程 + uvicorn worker
pip install gunicorn
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000
# -w 通常设为 CPU 核数 * 2 + 1
十、学习路线对照课程大纲
按 37 节推进：
- 第 1~6 节：Web 模式、ASGI、第一个程序、路由与启动、路由分发——把”怎么起服务、怎么组织路由”搞清楚。
- 第 7~12 节：路径/查询/请求体传参与数据校验——FastAPI 最核心的生产力部分，务必练熟。
- 第 13~22 节：SQLAlchemy engine、模型类、alembic 迁移、session 增删改查——ORM 基本功。
- 第 23~31 节：一对多、自关联树、一对一、多对多、复杂关联查询——数据库设计进阶。
- 第 32~37 节：schemas、依赖注入、ORM→Schema 转换、嵌套查询、分页、修改删除——完成一个 CRUD 闭环。
十一、常见问题 FAQ
Q1：启动后访问 /docs 白屏或加载慢？ Swagger 前端资源走 CDN，国内网络偶尔拉不下来。可以在 FastAPI 实例里指定本地静态资源路径，或用 nginx 反代。
Q2：async def 里调用同步 ORM 卡死？
把路由改成普通 def，FastAPI 会自动线程池执行；或者换异步 ORM（SQLAlchemy 2.0 async）。
Q3：Pydantic v1 和 v2 差异大吗？
v2 性能高很多，语法基本兼容。新学直接按 v2 写，from pydantic import BaseModel 即可。
Q4：依赖注入和中间件怎么选？ 中间件处理全局横切（日志、CORS、鉴权），依赖处理路由级可复用逻辑（拿 db session、当前用户）。能注入就别写中间件。
十二、写在最后
FastAPI 是当下 Python 后端最值得投入的框架之一，尤其在做 AI 应用后端、微服务、数据接口时，开发体验和性能都很好。这套 37 节带源码的课程正好覆盖了”框架 + ORM + 一个完整 CRUD 项目”的最小闭环，跟下来再自己加个 JWT 登录和分页，就足以写出能上线的接口了。
📁 目录结构
目录概览
- 📂 注意：部分视频含有水印，切勿相信
📋 点击展开查看课程模块大纲
FastAPI 课程模块大纲（37 节 + 课程资料.7z）
── 模块一：Web 基础与 FastAPI 入门（01~06）
│ ├── Web 开发模式 / ASGI 协议与服务
│ ├── 第一个 FastAPI 程序 / 接口文档打开慢的问题
│ └── 路由与启动方式、路由分发
── 模块二：路由传参与数据校验（07~12）
│ ├── 路由传参（一）（二） / URL 传参
│ ├── 传参数据校验 / 请求体传参 / 请求体单个传参
├── 模块三：SQLAlchemy 基础（13~22）
│ ├── SQLAlchemy 介绍 / 创建 engine / 模型类（一）（二）
│ ├── alembic 数据库迁移
│ └── session 新增 / 简单查询 / 修改 / 删除 / 高级查询
── 模块四：ORM 关联关系（23~31）
│ ├── 一对多 / 双向关联迁移 / 一对多关联操作
│ ├── 树形结构自关联 / 树形结构操作
│ ├── 一对一 / 多对多关联
│ └── 关联复杂查询（一）（二）
├── 模块五：员工管理 CRUD 实战（32~37）
│ ├── 定义添加员工 schemas / session 依赖注入 / ORM 模型对象转换
│ ├── 查询单个员工与模型嵌套 / 分页查询员工
│ └── 修改和删除员工
└── 📄 课程资料.7z
资源获取
💡 建议：尽快保存到本地网盘或电脑，避免分享链接后期失效。
整理不易，如果对你有帮助，欢迎分享给更多需要的朋友。
请登录后查看评论内容