Pydantic（Pydantic）

Pydantic 是一个通过标准 Python 类型注解定义数据模型的数据验证库。 PyCharm 为 Pydantic 模型提供了专门支持，构建在与其他类型提示功能相同的类型引擎之上。

支持涵盖 pydantic.BaseModel 及其子类、 pydantic.dataclasses.dataclass 、泛型模型，以及相关构造，如 字段 、模型和字段验证器及 ConfigDict 选项。支持识别 Pydantic v1 和 v2。

模型字段的代码洞察

实例化 Pydantic 模型时，PyCharm 会将已声明的字段视为 __init__ 的关键字实参，并提供以下代码洞察：

字段名的关键字实参补全，包括其声明类型和默认值。
针对每个字段传递值时的类型检查，依据相应的注解进行。
检查会高亮显示缺失的必填字段，并提供快速修复功能以插入未填充实参的占位符。
支持从 __init__ 调用中的关键字实参导航到字段声明及返回，包括跨子类和基类。

            from pydantic import BaseModel

            class User(BaseModel):
                id: int
                name: str = "anonymous"
                is_active: bool = True

            User(id=1, name="Alice")          # valid
            User(id="not-an-int")             # type mismatch on id, name is missing
        
  

重构和验证器

重命名模型字段会更新 __init__ 调用中的所有关键字实参，并将更改传播到子类和基类。在 __init__ 调用中重命名关键字实参时，会同步更新对应的字段声明。

用 @field_validator、 @model_validator 或传统 @validator 和 @root_validator 装饰器声明的字段和模型验证器均可识别：第一个参数类型将自动设置，并且为装饰后的函数调整标准检查，避免产生误报。

2026年 7月 14日

Pydantic​（Pydantic）

模型字段的代码洞察

重构和验证器

Pydantic（Pydantic）