将Pydantic模型导出为字典时的正确类型提示用法

方案1：手动定义对应TypedDict #

如果模型字段数量不多且变更频率低，直接手动编写与Pydantic模型字段一一对应的TypedDict，作为方法的返回类型标注即可。IDE会自动识别字典的所有键和对应类型，提前提供补全和错误检查。

from typing import TypedDict
from pydantic import BaseModel

# 你的Pydantic验证模型
class ExcelRowModel(BaseModel):
    name: str
    age: int
    email: str

# 与模型字段完全匹配的TypedDict类型
class ExcelRowDict(TypedDict):
    name: str
    age: int
    email: str

# 处理Excel行的方法
def process_excel_row(sheet_row: dict) -> ExcelRowDict:
    model = ExcelRowModel(**sheet_row)
    # 推荐用model_dump()替代dict(**sheet_row)，更贴合Pydantic规范
    return model.model_dump()

方案2：动态生成对应TypedDict（适配多字段/易变模型） #

如果模型字段较多或经常修改，手动同步TypedDict效率太低，可以利用Pydantic的model_fields属性动态生成对应的字典类型：

from typing import TypedDict, TypeVar, Type
from pydantic import BaseModel

T = TypeVar('T', bound=BaseModel)

def create_dict_type(model_cls: Type[T]) -> type[TypedDict]:
    # 从模型中提取所有字段名和对应的类型注解
    field_types = {
        field.name: field.annotation
        for field in model_cls.model_fields.values()
    }
    # 动态创建与模型绑定的TypedDict
    return TypedDict(f"{model_cls.__name__}Dict", **field_types)

# 定义示例模型
class UserRowModel(BaseModel):
    id: int
    username: str
    is_active: bool

# 自动生成对应的字典类型
UserRowDict = create_dict_type(UserRowModel)

# 处理方法的类型标注
def process_user_row(sheet_row: dict) -> UserRowDict:
    model = UserRowModel(**sheet_row)
    return model.model_dump()

方案3：结合泛型实现抽象模块的类型推导 #

如果你的模块是抽象类结构，可以通过泛型让子类指定具体模型，自动推导返回的字典类型：

from abc import ABC, abstractmethod
from typing import TypeVar, Type, TypedDict
from pydantic import BaseModel

TModel = TypeVar('TModel', bound=BaseModel)
TDict = TypeVar('TDict', bound=TypedDict)

class ExcelProcessor(ABC, generic=(TModel, TDict)):
    @abstractmethod
    def process_row(self, sheet_row: dict) -> TDict:
        pass

# 子类绑定具体模型和对应的字典类型
class UserExcelProcessor(ExcelProcessor[UserRowModel, UserRowDict]):
    def process_row(self, sheet_row: dict) -> UserRowDict:
        model = UserRowModel(**sheet_row)
        return model.model_dump()

关键说明 #

• 避免使用MyCustomModel.__dict__作为类型提示：__dict__是实例的属性（返回mappingproxy对象），并非合法的类型注解，因此会触发类型错误。
• 优先使用model_dump()：相比dict(model)，它支持Pydantic的exclude/include配置，返回的字典结构更符合预期。

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