如何在Pydantic中隐藏字段h且仍可访问？schema_extra失效问题

问题原因 #

你之前用的schema_extra是用来修改JSON Schema生成结果的，只有调用User.model_json_schema()时才会执行，和model_dump()的序列化输出逻辑完全无关，所以里面的print不会触发，也无法控制dump后的字段。另外hidden=True不是Pydantic Field的内置参数，不会被自动识别处理。

正确实现方式 #

要实现「调用model_dump()不返回h字段，但仍能通过s.h访问」的需求，直接用Field的exclude=True参数即可，这是Pydantic 2.x专门用于控制序列化排除字段的内置配置：

from pydantic import BaseModel, Field

class User(BaseModel):
    p: str
    # 使用exclude=True，让字段默认不参与序列化
    h: str = Field(exclude=True)

s = User(p='1', h='2')
print(s.model_dump())  # 输出: {'p': '1'}
print(s.h)  # 输出: '2'，仍能正常访问字段值

备选方案（按需选择） #

如果需要临时保留h字段的序列化能力，可以不设置Field的exclude，而是在调用model_dump()时手动指定排除字段：

s = User(p='1', h='2')
# 仅本次dump排除h字段
print(s.model_dump(exclude={'h'}))  # 输出: {'p': '1'}
# 不排除的话仍能输出全部字段
print(s.model_dump())  # 输出: {'p': '1', 'h': '2'}

补充说明 #

• 不要用PrivateAttr()，因为它定义的是实例私有属性，无法直接通过s.h访问（需要通过s.__dict__['_g']这类方式），不符合你的需求。
• schema_extra的正确使用场景是自定义API文档的JSON Schema结构，比如隐藏字段在Schema中的显示，而非控制实例的序列化输出。

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