如何将JSON数据转换为Python自定义模型类实例？

问题场景 #

你已经定义了Hometown和Person两个自定义模型类，希望把JSON数据直接转换成Person实例（其中hometown属性是Hometown实例），而不是用SimpleNamespace——因为后者无法让编辑器提供属性自动补全功能。

解决方案：手动实现JSON到类实例的转换 #

方法1：使用dataclasses（Python 3.7+，推荐） #

利用标准库的dataclasses简化类定义，同时添加类方法完成JSON转换：

from dataclasses import dataclass
import json

@dataclass
class Hometown:
    city: str
    country: str

@dataclass
class Person:
    name: str
    age: int
    hometown: Hometown

    @classmethod
    def from_json(cls, json_str: str) -> "Person":
        # 解析JSON为字典
        data = json.loads(json_str)
        # 将嵌套的hometown字典转为Hometown实例
        data["hometown"] = Hometown(**data["hometown"])
        # 返回Person实例
        return cls(**data)

使用示例 #

# 测试用JSON数据
sample_json = '''
{
    "name": "Alice",
    "age": 30,
    "hometown": {
        "city": "Shanghai",
        "country": "China"
    }
}
'''

# 转换为Person实例
person = Person.from_json(sample_json)

# 访问属性（编辑器会提供自动补全）
print(person.name)               # 输出: Alice
print(person.hometown.city)      # 输出: Shanghai

方法2：手动定义类构造函数 #

如果不想用dataclasses，可以直接在类中编写转换逻辑：

import json

class Hometown:
    def __init__(self, city: str, country: str):
        self.city = city
        self.country = country

class Person:
    def __init__(self, name: str, age: int, hometown: Hometown):
        self.name = name
        self.age = age
        self.hometown = hometown

    @classmethod
    def from_json(cls, json_str: str) -> "Person":
        data = json.loads(json_str)
        # 单独处理嵌套的Hometown
        hometown = Hometown(**data.pop("hometown"))
        return cls(hometown=hometown, **data)

核心思路 #

1. 先将JSON字符串解析为Python字典
2. 处理嵌套结构：把字典中对应嵌套类的部分，手动转换为目标类的实例
3. 用字典解包（**data）的方式，将参数传入自定义类的构造函数，生成实例

这种方式下，编辑器能识别类的属性类型，自然就能提供自动补全，完美解决SimpleNamespace的局限性。

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