如何让Pydantic v2完全忽略类中的指定字段？

要让Pydantic完全忽略某些字段（不参与验证、序列化、__eq__、__repr__等任何模型相关操作），你之前尝试的PrivateAttr()或下划线开头带类型注解的方式都不适用——因为这些会被Pydantic识别为私有模型字段，纳入内部管理流程。以下是两种符合需求的实现方式：

方法1：定义无类型注解的普通实例属性 #

直接在类体中定义不带类型注解的属性，Pydantic会将其视为普通Python实例属性，完全不进行任何模型层面的处理：

from pydantic import BaseModel
import random

class A(BaseModel):
    f: int
    # 无类型注解，Pydantic完全忽略该属性
    _pf = None

    @model_validator(mode="after")
    def after(self):
        self._pf = random.choice(list(range(10000)))

def test_a():
    a = A(f=1)
    b = A(f=1)
    assert a == b  # 测试通过，_pf不参与__eq__比较
    print(repr(a))  # 输出：A(f=1)，不包含_pf
    print(a.model_dump())  # 输出：{'f': 1}，不包含_pf

方法2：带类型注解时手动排除模型字段 #

如果需要给属性添加类型注解，可以在类定义后手动从Pydantic的字段集合中删除该属性，强制让Pydantic忽略它：

from pydantic import BaseModel
import random

class A(BaseModel):
    f: int
    # 带类型注解，后续手动排除
    _pf: int | None = None

    @model_validator(mode="after")
    def after(self):
        self._pf = random.choice(list(range(10000)))

# 手动从Pydantic的字段列表中删除_pf，使其不参与任何模型操作
del A.__pydantic_fields__['_pf']

def test_a():
    a = A(f=1)
    b = A(f=1)
    assert a == b  # 测试通过

关键注意事项 #

• 避免使用PrivateAttr()或下划线开头带类型注解的定义方式，这些会被Pydantic纳入私有字段管理，依然会参与__eq__、__repr__等操作。
• 对比@property方案，上述两种方法更接近普通类字段的直接访问体验，无需通过方法调用获取值。

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