如何为Python Dataclass实现自动接收字典的自定义构造方法？

方案1：自定义__init__直接接收字典 #

通过禁用dataclass自动生成的__init__，手动实现一个能接收字典并自动填充字段的构造方法：

from dataclasses import dataclass, fields

@dataclass(init=False)
class SoldItem:
    title: str
    price: float
    quantity: int

    def __init__(self, data):
        if not isinstance(data, dict):
            raise TypeError("必须传入字典类型参数")
        
        # 遍历dataclass字段，从字典中取值赋值
        for field in fields(self):
            value = data.get(field.name)
            # 校验必填字段（如果需要）
            if value is None and field.default is None and field.default_factory is None:
                raise ValueError(f"缺少必填字段: {field.name}")
            setattr(self, field.name, value)

使用方式：

json_data = {"title": "Python入门指南", "price": 59.9, "quantity": 100}
item = SoldItem(json_data)

方案2：用类方法from_dict实现（保留默认构造） #

如果不想覆盖默认的__init__，可以新增一个类方法专门处理字典转实例：

from dataclasses import dataclass, fields

@dataclass
class SoldItem:
    title: str
    price: float
    quantity: int

    @classmethod
    def from_dict(cls, data):
        if not isinstance(data, dict):
            raise TypeError("必须传入字典类型参数")
        
        # 仅保留dataclass定义的字段，避免多余键引发错误
        filtered_data = {
            field.name: data.get(field.name) 
            for field in fields(cls)
        }
        return cls(**filtered_data)

使用方式：

json_data = {"title": "Python入门指南", "price": 59.9, "quantity": 100}
item = SoldItem.from_dict(json_data)

方案3：支持嵌套Dataclass的扩展版 #

如果你的dataclass包含其他dataclass类型的字段，可以递归处理字典数据：

from dataclasses import dataclass, fields

@dataclass
class Seller:
    name: str
    seller_id: int

@dataclass(init=False)
class SoldItem:
    title: str
    price: float
    quantity: int
    seller: Seller

    def __init__(self, data):
        if not isinstance(data, dict):
            raise TypeError("必须传入字典类型参数")
        
        for field in fields(self):
            field_type = field.type
            value = data.get(field.name)
            
            # 处理嵌套的dataclass字段
            if hasattr(field_type, '__dataclass_fields__'):
                if not isinstance(value, dict):
                    raise ValueError(f"字段{field.name}需要传入字典类型数据")
                setattr(self, field.name, field_type(value))
            else:
                if value is None and field.default is None and field.default_factory is None:
                    raise ValueError(f"缺少必填字段: {field.name}")
                setattr(self, field.name, value)

使用方式：

json_data = {
    "title": "Python入门指南", 
    "price": 59.9, 
    "quantity": 100,
    "seller": {"name": "技术出版社", "seller_id": 123}
}
item = SoldItem(json_data)

关键注意事项 #

• 字典的键名必须和dataclass的字段名完全匹配，否则会无法赋值（或赋值为None）
• 如果需要严格校验必填字段，可以在赋值前判断value是否为None并抛出异常
• 若字典中存在多余的键，方案2会自动过滤，避免传入未定义字段导致的错误

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