Python 中 Pydantic库 是什么，怎么用？

Python 中 Pydantic库 是什么，怎么用？

qweasdzxc

PKU undergraduate student

2 人赞同了该文章

Pydantic 是 Python 里一个非常流行的数据验证与数据模型构建库，最大的特点是用 Python 类型注解（type hints）来做数据验证和转换。

官方文档库：https://pydantic.com.cn/

1. 核心功能如下

Pydantic 的核心是 BaseModel 类

自动类型转换：即使输入的类型不完全正确，也会自动尝试转换（比如字符串 "123" 自动转为整数）。

数据验证：根据字段的类型和限制条件自动校验。

自动文档化：配合 FastAPI 直接生成 Swagger 文档。

嵌套模型：字段里可以嵌套另一个模型。

JSON 解析/导出：模型可以很方便地从/转为 JSON、字典等。

2. 什么是数据验证库？Pydantic为啥是数据验证库的一种？

就是一种 专门用来检查数据是否符合预期格式和规则的工具。

在HTTP请求、数据库读取等场景会使用到。

优势特征：

• 自动转化类型
• 防御无效数据

例子：

from pydantic import BaseModel, Fieldclass User(BaseModel):id: intname: strage: int = Field(gt=0, lt=120)  # 年龄必须在 1~119# 有效数据
user = User(id="123", name="Alice", age=25)
print(user.id, type(user.id))  # 123 <class 'int'># 无效数据
User(id="abc", name="Bob", age=-5)
# 会报错：value is not a valid integer / ensure this value is greater than 0

 

发布于 2025-08-13 20:25・北京