第一章：FastAPI 基础

本章目标

理解 FastAPI 的核心机制：类型提示驱动、自动验证、自动文档生成。掌握路径操作、参数绑定、请求响应的基础。

学习路径

1. 心智模型 - 理解 FastAPI 的设计哲学
2. 可运行实验 - 第一个 API 实验
3. 调试与边界 - 错误处理和边界情况
4. 练习答案 - 完整练习答案

关键概念

FastAPI 通过 Python 类型提示实现：

• 自动验证：参数类型错误自动返回 422
• 自动文档：访问 /docs 查看交互式 API 文档
• 编辑器支持：IDE 自动补全和类型检查

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Item(BaseModel):
    name: str
    price: float

@app.post("/items/")
async def create_item(item: Item):
    return {"item_name": item.name, "price": item.price}

访问 http://localhost:8000/docs 查看自动生成的文档。