第一章：基础继承机制
1.1 简单继承模型
PYTHON

from pydantic import BaseModel


class UserBase(BaseModel):
    email: str
    is_active: bool = True


class UserCreate(UserBase):
    password: str  # 新增字段
    is_active: bool = False  # 覆盖父类默认值


# 验证示例
user = UserCreate(email="test@example.com", password="secret")
print(user.is_active)  # 输出: False

继承规则：

子类自动获得父类所有字段
字段默认值可被覆盖
新增字段需明确声明
1.2 字段类型强化
PYTHON

from pydantic import Field


class StrictUser(UserBase):
    email: str = Field(..., regex=r"^[\w\.]+@[a-zA-Z]+\.[a-zA-Z]+$")
    age: int = Field(ge=18, lt=100)  # 新增约束字段

第二章：字段覆盖策略
2.1 默认值覆盖
PYTHON

class ConfigBase(BaseModel):
    timeout: int = 10
    retries: int = 3


class ProductionConfig(ConfigBase):
    timeout: int = 30  # 覆盖默认值
    log_level: str = "ERROR"  # 新增字段

2.2 类型约束升级
PYTHON

class PaymentBase(BaseModel):
    amount: float


class StrictPayment(PaymentBase):
    amount: confloat(gt=0)  # 强化类型约束

覆盖规则矩阵：

from pydantic import Field


class Animal(BaseModel):
    type: str = Field(..., alias="_type")


class Cat(Animal):
    _type: str = "cat"
    lives: int


class Dog(Animal):
    _type: str = "dog"
    breed: str


def parse_animal(data: dict) -> Animal:
    type_map = {
        "cat": Cat,
        "dog": Dog
    }
    return type_map[data["_type"]](**data)

3.2 自动化模型解析
PYTHON

from pydantic import create_model

DynamicModel = create_model(
    'DynamicModel',
    __base__=UserBase,
    role=(str, Field(regex="^(admin|user)$"))
)

第四章：配置继承体系
4.1 全局配置继承
PYTHON

class Parent(BaseModel):
    class Config:
        extra = "forbid"
        anystr_strip_whitespace = True


class Child(Parent):
    class Config(Parent.Config):
        validate_assignment = True

配置继承规则：

使用Config(Parent.Config)显式继承
未指定时默认不继承父类配置
支持多级配置覆盖
4.2 运行时配置修改
PYTHON

from pydantic import BaseModel, Extra


class FlexibleModel(BaseModel):
    class Config:
        extra = Extra.allow


StrictModel = type(
    'StrictModel',
    (FlexibleModel,),
    {'Config': type('Config', (FlexibleModel.Config,), {'extra': Extra.ignore})}
)

第五章：高级继承技巧
5.1 Mixin类设计
PYTHON

class TimestampMixin(BaseModel):
    created_at: datetime = Field(default_factory=datetime.now)
    updated_at: datetime = Field(default_factory=datetime.now)


class UserWithTime(TimestampMixin, UserBase):
    pass

5.2 动态模型生成
PYTHON

def create_model_with_extra_fields(base: Type[BaseModel], **fields):
    return create_model(
        f'Extended{base.__name__}',
        __base__=base,
        **fields
    )


ExtendedUser = create_model_with_extra_fields(
    UserBase,
    phone=(str, Field(regex=r"^1[3-9]\d{9}$"))
)

第六章：错误处理与调试
6.1 继承错误分析
PYTHON

try:
    class InvalidModel(UserBase):
        email: int  # 类型冲突
except TypeError as e:
    print(f"继承错误: {e}")

常见错误码：

错误类型 触发场景 解决方案
ValidationError 字段类型不匹配 检查继承链中的类型定义
TypeError 不兼容字段覆盖 使用@validator处理转型逻辑
ConfigConflict 配置项冲突 显式指定配置继承关系
6.2 调试继承体系
PYTHON

def print_model_fields(model: Type[BaseModel]):
    for name, field in model.__fields__.items():
        print(f"{name}: {field.type_} (default={field.default})")


print_model_fields(StrictPayment)

课后Quiz
Q1：如何实现字段默认值覆盖？
A) 在子类重新声明字段
B) 使用Field(default=…)
C) 修改父类定义

Q2：多态模型必须包含什么特征？

鉴别器字段
相同字段数量
统一校验规则
Q3：处理类型冲突的最佳方式？

使用@validator进行数据转换
强制类型转换
忽略类型检查
错误解决方案速查表

开发箴言：优秀的模型继承设计应遵循LSP（里氏替换原则），任何父类出现的地方都可以被子类替换。建议继承层级不超过3层，复杂场景优先选择组合模式而非深度继承。

来源：https://blog.cmdragon.cn/posts/3e5fa6671c1c/