Pydantic，验证数据结构的 Python 神器！

在Python的日常开发中，数据的验证和处理就像生活中的配菜，你可以偷懒不做，但最后上桌的时候，可能不太能看。今天聊一个能让数据验证变得特别简单又好用的库——Pydantic。它的核心能力是基于Python的类型注解，帮助我们快速验证和解析数据结构，关键是还非常优雅。

用Pydantic定义数据模型

Pydantic的强大从它的模型定义就能看出来。你只需要继承它的BaseModel，就能轻松定义出一套结构清晰、类型安全的数据模型。

from pydantic import BaseModel

class User(BaseModel):
    id: int
    name: str
    email: str
    age: int = 18  # 默认值

# 示例：创建一个用户对象
user = User(id=1, name="老李", email="laoli@example.com")
print(user)

运行这段代码，输出的用户对象不仅清晰明了，还会帮你自动完成缺省值填充，少了很多手动处理的麻烦。如果传入的数据类型对不上，直接就会报错，拦住了问题。

温馨提示：字段类型和默认值最好都标清楚，默认值写得不对，也会让人一头雾水。

数据验证：输入不对，Pydantic不惯着

一旦传入数据有问题，Pydantic可不是和稀泥的那种，它会毫不客气地报错。这种严谨的态度，开发时候可能会让你抓狂，但上线了你一定会感激它。

try:
    bad_user = User(id="wrong_type", name="老李", email="laoli@example.com")
except Exception as e:
    print(e)

错误信息直接告诉你哪儿不对，比如这里的id需要是个int，你却给了个str。这让你根本没机会让坏数据偷偷溜过。

支持嵌套模型，数据复杂也不怕

生活哪有那么简单，很多时候你的数据结构复杂得让人头疼。还好，Pydantic对嵌套结构的支持也特别顺滑。

class Address(BaseModel):
    city: str
    street: str

class UserWithAddress(BaseModel):
    id: int
    name: str
    address: Address

# 示例：创建用户带地址
user_with_address = UserWithAddress(
    id=1,
    name="老李",
    address={"city": "北京", "street": "长安街"}
)
print(user_with_address)

嵌套模型让数据组织得更加合理，同时你还能享受嵌套验证的福利。比如地址结构写错了，它立刻就会提醒你。

数据的自动解析与转换

Pydantic不仅能验证数据，还会自动把一些格式对不上的数据转成目标格式，特别适合处理用户输入的各种"惊喜"。

class Product(BaseModel):
    price: float
    in_stock: bool

product = Product(price="19.99", in_stock="True")
print(product)

输出中，price自动转成了浮点数，in_stock也被处理成布尔值。这种智能转换让你写代码的时候少了很多额外操作。

高效处理大批量数据

对于需要处理大量数据的场景，Pydantic也不含糊。它有个专门的方法叫parse_obj，让你能快速解析列表或字典里的数据。

users_data = [
    {"id": 1, "name": "老李", "email": "laoli@example.com"},
    {"id": 2, "name": "小张", "email": "xiaozhang@example.com"},
]

from pydantic import parse_obj_as
users = parse_obj_as(list[User], users_data)
print(users)

一次性处理成批的数据，直接返回了一组User对象，效率杠杠的。

一些小坑与注意事项

未定义的字段：Pydantic默认会拒绝所有你没定义的字段，如果你的输入数据包含了额外信息，记得开启extra="allow"。

from pydantic import BaseModel, Extra

class FlexibleModel(BaseModel):
    id: int
    name: str

    class Config:
        extra = Extra.allow

flexible_user = FlexibleModel(id=1, name="老李", nickname="Python大神")
print(flexible_user)

数据字段重命名：有时候字段名字不好改，但你可以用Pydantic的alias特性，给它起个别名。

class RenamedModel(BaseModel):
    user_id: int = Field(..., alias="id")

renamed_user = RenamedModel(id=123)
print(renamed_user)

模型的默认值：如果默认值是个可变对象，比如列表或字典，记得用Field(default_factory=...)，不然可能会翻车。

Pydantic可以说是验证数据结构的全能选手，不仅操作简单，还能省去不少繁琐代码，尤其是数据来源复杂的时候，用它绝对是一种享受！

目录CONTENT