Day 15 · FastAPI 入门

Week 3 · Day 15 / 56 · 返回大纲

一、安装 FastAPI

uv add fastapi "uvicorn[standard]"

# 验证
uv run python -c "import fastapi; print(fastapi.__version__)"
💡 uvicorn: ASGI 服务器,负责运行 FastAPI 应用。类比 JS 的 Node.js + Express。

二、第一个 API

# main.py
from fastapi import FastAPI

app = FastAPI(title="我的第一个 API")

@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI!"}

@app.get("/hello/{name}")
def say_hello(name: str):
    return {"message": f"你好,{name}!"}

# 启动
uvicorn main:app --reload
# 访问 http://127.0.0.1:8000
# 自动文档 http://127.0.0.1:8000/docs
@app.get("/") 是什么?

三、路径参数和查询参数

# 路径参数(必选)
@app.get("/users/{user_id}")
def get_user(user_id: int):
    return {"user_id": user_id}
# /users/1 → {"user_id": 1}

# 查询参数(可选)
@app.get("/search")
def search(q: str, limit: int = 10):
    return {"query": q, "limit": limit}
# /search?q=python&limit=20

# 混合
@app.get("/users/{user_id}/posts")
def get_user_posts(user_id: int, published: bool = True):
    return {"user_id": user_id, "published": published}
# /users/1/posts?published=false

四、交互式文档

FastAPI 最大的卖点:自动生成 OpenAPI 文档。

动手练习

练习 1:第一个 API
写一个返回你名字的 API
@app.get("/me")
def me():
    return {"name": "张三", "role": "前端工程师→Python"}
查看答案
参考答案
# 启动后访问 http://127.0.0.1:8000/me
练习 2:加法 API
写一个接收两个数字的加法 API
@app.get("/add/{a}/{b}")
def add(a: int, b: int):
    return {"result": a + b, "expression": f"{a}+{b}={a+b}"}
查看答案
参考答案
# /add/3/5 → {"result": 8}
练习 3:查询参数
写一个带分页参数的列表 API
@app.get("/items")
def list_items(page: int = 1, size: int = 10):
    return {"page": page, "size": size, "items": [...]}
查看答案
参考答案
# /items?page=2&size=20

打卡验收

安装 FastAPI 和 uvicorn
能启动 uvicorn 服务器
理解 @app.get 装饰器
会定义路径参数和查询参数
知道自动文档 /docs 的作用
完成 3 个动手练习
能向别人演示你的第一个 API
理解返回值自动转 JSON
打卡方式: 全部勾选后,告诉我 "Day 15 打卡",并贴出你的代码。