第一章：开发环境搭建
1.1 虚拟环境全方案对比

BASH

# 方案1：venv（Python原生）
python -m venv fastapi-env
source fastapi-env/bin/activate  # Linux/Mac
fastapi-env\Scripts\activate     # Windows

# 方案2：pipenv（推荐）
pip install pipenv
pipenv install fastapi uvicorn

# 方案3：poetry（进阶）
poetry new myapi
cd myapi
poetry add fastapi uvicorn

1.2 依赖管理黄金法则

TOML

# pyproject.toml 示例（使用poetry）
[tool.poetry.dependencies]
python = "^3.8"
fastapi = "^0.115.10"
uvicorn = {extras = ["standard"], version = "^0.23.0"}

# 安装命令
poetry install  # 自动解析依赖

第二章：第一个智能API
2.1 最小化API代码

PYTHON

# main.py
from fastapi import FastAPI

app = FastAPI(
    title="智能天气API",
    description="实时获取天气数据",
    version="0.1.0"
)

@app.get("/weather/{city}")
async def get_weather(city: str, days: int = 7):
    return {
        "city": city,
        "forecast": [
            {"day": i+1, "temp": 25+i} 
            for i in range(days)
        ]
    }

2.2 运行与测试

BASH

# 开发模式（热重载）
uvicorn main:app --reload

# 生产模式
gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app

第三章：自动文档生成
3.1 Swagger UI访问
访问 http://localhost:8000/docs 你将看到：
Swagger UI界面

3.2 文档增强技巧
PYTHON

@app.get(
    "/weather/{city}",
    summary="获取城市天气",
    response_description="未来天气预测",
    tags=["气象服务"]
)
async def get_weather(...):
    ...

第四章：课后实战工坊
任务1：扩展健康检查接口

PYTHON

# 要求：
# 1. 访问 /health 返回服务器状态
# 2. 包含服务器时间戳
# 3. 响应状态码200

@app.get("/health")
async def health_check():
    # 你的代码

任务2：防御恶意参数攻击

PYTHON

# 危险代码
@app.get("/user/{user_id}")
async def get_user(user_id: str):
    query = f"SELECT * FROM users WHERE id = {user_id}"
    
# 任务：使用类型提示+参数化查询改写

常见错误解决方案

来源：https://blog.cmdragon.cn/posts/4e5a7adbcde4/