如何为Pydantic字段添加并检索自定义元数据？

1. 当前实现方式是否正确？ #

你的实现是完全正确的。Pydantic 2.x 支持在Annotated中添加任意自定义元数据对象，MyFieldMetadata作为结构化的元数据载体，既不会干扰字段的验证逻辑（由Field负责），也不会影响序列化/反序列化流程，完全符合“仅用于数据展示或输入提示”的需求，这也是Pydantic官方认可的扩展字段元数据的方式。

2. 更简洁的元数据查找方法 #

方式一：封装工具函数复用查找逻辑 #

把遍历metadata的逻辑抽成工具函数，避免重复写生成器表达式：

def get_metadata(field_info, metadata_type):
    return next((m for m in field_info.metadata if isinstance(m, metadata_type)), None)

# 使用示例
m = MyModel(length=10.0, duration=60.0)
for field_name, field_info in m.model_fields.items():
    extra_info = get_metadata(field_info, MyFieldMetadata)
    print(f"{field_name}: {getattr(m, field_name)} {extra_info.unit if extra_info else ''}")

方式二：用Field的extra参数轻量化实现 #

如果你的元数据结构简单（比如仅需单位），可以直接把元数据放到Field的extra字典里，不用单独定义dataclass，查找更直接：

from pydantic import BaseModel, Field
from typing import Annotated

class MyModel(BaseModel):
    length: Annotated[float, Field(gte=0.0, extra={"unit": "meter"})]
    duration: Annotated[float, Field(gte=0.0, extra={"unit": "seconds"})]

# 打印逻辑简化
m = MyModel(length=10.0, duration=60.0)
for field_name, field_info in m.model_fields.items():
    unit = field_info.field_info.extra.get("unit", "")
    print(f"{field_name}: {getattr(m, field_name)} {unit}")

方式三：给自定义元数据类添加类方法 #

在MyFieldMetadata中添加类方法，直接从字段信息里提取自身实例，代码更语义化：

from dataclasses import dataclass
from pydantic.fields import FieldInfo

@dataclass
class MyFieldMetadata:
    unit: str

    @classmethod
    def extract(cls, field_info: FieldInfo):
        return next((m for m in field_info.metadata if isinstance(m, cls)), None)

# 使用示例
m = MyModel(length=10.0, duration=60.0)
for field_name, field_info in m.model_fields.items():
    extra_info = MyFieldMetadata.extract(field_info)
    print(f"{field_name}: {getattr(m, field_name)} {extra_info.unit if extra_info else ''}")

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