Pydantic是Python生态中最流行的数据验证库，其核心思想是利用Python的类型提示（Type Hints）在运行时对数据进行校验、转换和序列化。它的名字来源于"Python"和"Pedantic"（一丝不苟的）的组合，代表了它在数据处理上的严谨态度。目前，像FastAPI、LangChain等众多知名框架和项目都构建在Pydantic之上。
核心优势
基于类型提示：你只需要使用标准的Python类型注解来定义数据模型，Pydantic就能自动进行验证。这让代码简洁，且能与IDE和静态类型检查工具（如mypy、Pyright）完美集成。
高性能：Pydantic的核心验证逻辑是用Rust编写的，这使得它成为Python中最快的数据验证库之一。在基准测试中，它处理复杂数据（如解析和验证URL）的速度甚至比手写的专用代码还要快数倍。
强大的生态系统：Pydantic被广泛应用于Web开发（FastAPI、Django Ninja）、AI应用（LangChain）以及数据科学等领域。它每月下载量超过7000万次，是构建生产级Python应用的基石之一。
快速入门
安装：
pipinstallpydantic定义模型：
创建一个继承自BaseModel的类，并用类型注解声明字段。frompydanticimportBaseModelfromdatetimeimportdatetimeclassUser(BaseModel):id:int# 必填字段name:str='John Doe'# 有默认值，为可选字段signup_ts:datetime|None# 可为空，但提供值时必须为datetime类型数据验证与转换：
传入数据时，Pydantic会尝试进行智能类型转换，验证失败则抛出ValidationError。# 正常情况：字符串 "123" 会被自动转换为 intuser=User(id='123',signup_ts='2023-10-01 12:00')print(user.id)# 输出: 123 (int类型)print(user.signup_ts)# 输出: 2023-10-01 12:00:00 (datetime类型)# 验证失败的情况frompydanticimportValidationErrortry:User(id='not_a_number',signup_ts=None)exceptValidationErrorase:print(e.errors())
主要功能一览
| 功能 | 描述 | 示例/方法 |
|---|---|---|
| 字段约束与定制 | 通过Field函数为字段添加长度、数值范围、正则表达式等额外约束和元数据。 | name: str = Field(min_length=1, max_length=10) |
| 自定义验证器 | 使用@field_validator和@model_validator装饰器编写复杂的、跨字段的业务逻辑验证。 | @field_validator('age', mode='after') |
| 数据序列化 | 将模型实例转换为Python字典或JSON字符串，并可控制字段的包含与排除。 | user.model_dump(),user.model_dump_json() |
| 生成JSON Schema | 一键生成符合规范的JSON Schema，方便API文档自动生成和前后端数据契约校验。 | User.model_json_schema() |
| 支持多种数据结构 | 除了BaseModel，还支持验证标准库的dataclass、TypedDict，甚至普通函数参数（通过@validate_call）。 | - |
| 配置与模式 | 通过model_config设置模型行为，如切换严格模式（禁止自动类型转换）或控制额外字段的处理方式。 | model_config = ConfigDict(strict=True) |
版本说明
- Pydantic V2是一个有重大改进的版本，其核心性能由Rust实现，API也有部分调整（如
@validator改为@field_validator）。V1版本已停止积极开发，强烈建议新项目直接使用V2版本。 - V2的破坏性变更是一次性的，官方承诺未来不会再有如此大的变更，以确保版本升级的平滑。
总结
Pydantic通过优雅地结合Python的类型提示、高性能的Rust核心和丰富的功能，将数据验证从繁琐的if检查中解放出来。它不仅是构建健壮API的利器，现在也是确保AI应用输出可靠性的重要工具，是Python开发者工具箱中不可或缺的一员。