Pydantic 速查
共 26 条 Pydantic 用法，涵盖基础模型、字段约束、自定义校验、常用类型、Settings。 支持搜索与分类筛选，点击即可复制。
基础模型
基于类型注解做校验与转换。
| 命令 | 说明 |
|---|---|
| 引入基类 | |
| 定义模型 | |
| 自动类型转换（"1" → 1） | |
| 导出为 dict / JSON（v2） | |
| 从字典校验构造 |
字段约束
Field 与默认值。
| 命令 | 说明 |
|---|---|
| 引入 Field | |
| 数值范围约束 | |
| 字符串长度 | |
| 正则约束 | |
| 可变默认值用工厂 | |
| 可选字段 |
自定义校验
装饰器与配置。
| 命令 | 说明 |
|---|---|
| 单字段校验（v2） | |
| 跨字段校验（v2） | |
| 禁止多余字段（v2） | |
| 支持从对象属性构造（ORM 模式） | |
| 读取校验错误明细 |
常用类型
快捷类型。
| 命令 | 说明 |
|---|---|
| 邮箱 / URL（需 email-validator 等） | |
| 日期时间自动解析 | |
| UUID 类型 | |
| 枚举 | |
| IP 地址 / 敏感字符串 |
Settings
环境变量配置。
| 命令 | 说明 |
|---|---|
| 引入（pydantic-settings 包） | |
| 从环境变量读取配置 | |
| 读取 .env 文件 | |
| 环境变量前缀 | |
| 实例化即完成读取与校验 |
使用说明
Pydantic 速查：基础模型、字段约束、自定义校验、常用类型、Settings；支持搜索与分类筛选，点击即可复制。
- 按用途点分类：基础模型、字段约束、自定义校验、常用类型、Settings。
- 点「命令」列复制到代码。
- 模型负责解析与校验输入；用 model_dump/model_dump_json 输出。
- 配置项用 BaseSettings 从环境变量读取，避免把密钥写进代码。
常见问题
- v1 和 v2 差异大吗？
- 较大：v2 重写了核心（Rust），方法名改为 model_dump/model_validate，校验器改为 field_validator/model_validator，迁移有官方指引。
- 多余字段会被忽略吗？
- 默认忽略；要禁止可设 ConfigDict(extra="forbid")，能挡住拼写错误与脏字段。
- 需要联网吗？
- 不需要，本地可用。