标签: 数据验证

第一章：Pydantic 基础

什么是 Pydantic？

Pydantic 是 Python 中最流行的数据验证库，FastAPI 的核心依赖之一。它使用 Python 类型提示来进行数据验证、序列化和文档生成。

基础模型定义

from pydantic import BaseModel, Field
from typing import Optional, List
from datetime import datetime
from enum import Enum

# 基础模型
class User(BaseModel):
    id: int
    username: str
    email: str
    is_active: bool = True  # 默认值
    created_at: datetime = Field(default_factory=datetime.now)

# 使用模型
user = User(id=1, username="john", email="john@example.com")
print(user.model_dump())  # 转换为字典
print(user.model_dump_json())  # 转换为 JSON 字符串

# 从字典创建
data = {"id": 2, "username": "jane", "email": "jane@example.com"}
user2 = User.model_validate(data)

# 从 JSON 创建
json_str = '{"id": 3, "username": "bob", "email": "bob@example.com"}'
user3 = User.model_validate_json(json_str)

HSXISAWD2026/3/20大约 11 分钟