Python FastAPI 入门指南：从零构建生产级 RESTful API

安装完成后，创建一个 main.py 测试一下：

from fastapi import FastAPI

app = FastAPI()

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

启动服务：

uvicorn main:app --reload

浏览器打开 http://127.0.0.1:8000，看到 JSON 就成功了！再访问 http://127.0.0.1:8000/docs，会自动出现 Swagger 界面，恭喜你正式进入 FastAPI 世界。

核心概念速览

为了建立大局观，这里有几个关键概念需要理解：

实战案例：图书管理 API

我们用一个'简易图书管理系统'贯穿全文，边学边写。

定义数据模型

首先定义 models.py，利用 Pydantic 进行数据验证和序列化。

from pydantic import BaseModel, Field
from typing import Optional

class BookBase(BaseModel):
    title: str = Field(..., min_length=1, max_length=100)
    author: str = Field(..., min_length=1, max_length=50)
    year: int = Field(..., ge=1900, le=2100)

class BookCreate(BookBase):
    pass

class Book(BookBase):
    id: int
    is_available: bool = True

    class Config:
        from_attributes = True  # 兼容 ORM

这里要注意 Field 的使用，它不仅能限制长度，还能自动生成到 API 文档中，告诉调用者这个字段的约束条件。

编写路由逻辑

接下来在 main.py 中逐步添加功能。为了演示方便，我们先使用内存列表模拟数据库。

from fastapi import FastAPI, HTTPException, Query, Path
from typing import List
from models import Book, BookCreate

app = FastAPI(title="图书管理 API", version="0.1.0")

# 假数据库
books_db: List[Book] = [
    Book(id=1, title="Python 速成", author="重阳", year=2025),
]

@app.get("/books/", response_model=List[Book])
def get_books(
    skip: int = Query(0, ge=0),
    limit: int = Query(10, ge=1, le=100),
    author: Optional[str] = None
):
    result = books_db[skip : skip + limit]
    if author:
        result = [b for b in result if b.author.lower() == author.lower()]
    return result

@app.get("/books/{book_id}", response_model=Book)
def get_book(book_id: int = Path(..., ge=1)):
    for book in books_db:
        if book.id == book_id:
            return book
    raise HTTPException(status_code=404, detail="图书不存在")

@app.post("/books/", response_model=Book, status_code=201)
def create_book(book: BookCreate):
    new_id = max(b.id for b in books_db) + 1 if books_db else 1
    new_book = Book(id=new_id, **book.model_dump())
    books_db.append(new_book)
    return new_book

启动后就能在 Swagger 上直接测试增删改查了。你会发现，不需要写任何额外的验证代码，Pydantic 已经帮你处理好了输入校验，并且自动生成了接口文档。

下一步建议

掌握了基础后，你可以继续深入以下方向：

• 数据库连接：接入 PostgreSQL + SQLAlchemy 异步驱动。
• 安全基础：实现 JWT + OAuth2 认证。
• 项目结构：学习中大型项目的文件夹组织方式。
• 部署方案：Docker + gunicorn + uvicorn 的生产化配置。

这些内容将帮助你从 Demo 走向真正的生产环境。