如何在pydantic.BaseModel中实现带验证的私有属性及访问方法

你提到的PrivateAttr确实不适用这个场景，它的设计定位是存储完全不参与Pydantic初始化、校验、序列化流程的内部状态，不会帮你处理参数传入和类型校验。符合Pydantic惯用写法的实现方案如下（基于Pydantic v2，v1版本仅需少量API调整）：

from typing import Generic, TypeVar
from pydantic import BaseModel, Field, field_validator, ValidationInfo

T = TypeVar('T')

class MyClass(BaseModel, Generic[T]):
    # 定义存储字段，用alias匹配入参名value，exclude配置避免被序列化输出
    _value: T = Field(alias="value", exclude=True)

    # 可选getter
    @property
    def value(self) -> T:
        return self._value

    # 可选setter，赋值时自动触发校验
    @value.setter
    def value(self, new_val: T) -> None:
        # 复用Pydantic的校验逻辑，避免自定义校验重复代码
        validated_instance = type(self).model_validate({"value": new_val})
        self._value = validated_instance._value

    # 可选：自定义额外校验逻辑，无需可以删除
    @field_validator("_value", mode="before")
    @classmethod
    def custom_validate_value(cls, value: any, info: ValidationInfo) -> T:
        # 这里写你需要的自定义校验规则，示例为直接返回
        return value

方案特性说明 #

• 自动支持递归初始化：只要你实例化时指定了泛型T的具体类型，如果T是Pydantic模型，传入字典会被自动转换为对应的模型实例，完全符合你给出的示例要求

  # 示例子模型
  class SubModel(BaseModel):
      foo: str
      spam: str
  
  # 自动初始化SubModel实例到_value
  x = MyClass[SubModel](value={"foo": "bar", "spam": "ham"})
  print(x.value.foo) # 输出 bar
  

• 私有字段校验能力：初始化和setter赋值都会触发Pydantic的类型校验，非法值会直接抛出校验错误
• 字段隐私性：_value配置了exclude=True，调用model_dump()等序列化方法时不会被导出，符合私有字段不对外暴露的要求

什么时候适合用自定义类实现 #

如果你完全不需要Pydantic提供的序列化、JSON Schema生成、复杂校验规则等能力，只是需要最简单的属性封装，那可以用原生自定义类实现，否则用上述Pydantic方案可以省去大量手写校验、递归初始化的重复代码。

内容的提问来源于stack exchange，提问作者mkl