如何将包含类型对象的Python字典保存为JSON文件且保留原数据类型以用于后续类型校验

这个问题我之前也碰到过——JSON本身没法直接存储Python的类型对象（像tuple、int这种），直接用默认方法存的话，类型会被转成字符串，导回来根本没法用isinstance做校验。不过咱们可以通过自定义序列化和反序列化的逻辑来搞定，具体步骤如下：

因为JSON没有原生支持Python类型对象的能力，所以我们需要做三件事：

1. 自定义一个JSON编码器，把Python类型对象转换成JSON可存储的特殊标记结构
2. 自定义一个JSON解码器，读取JSON时把特殊标记还原回对应的Python类型
3. 用这两个自定义工具完成字典的存/取操作

1. 实现自定义编码器和解码器 #

我们可以通过继承json.JSONEncoder来扩展序列化逻辑，再写一个钩子函数处理反序列化：

import json

class TypeEncoder(json.JSONEncoder):
    def default(self, obj):
        # 识别Python内置类型对象
        if isinstance(obj, type):
            # 返回带类型标记的字典，方便后续还原
            return {'__type__': obj.__name__}
        # 其他类型交给默认逻辑处理
        return super().default(obj)

def type_decoder(obj):
    # 检查是否是我们标记的类型结构
    if '__type__' in obj:
        type_name = obj['__type__']
        # 从Python内置模块中获取对应的类型对象
        builtins = __import__('builtins')
        return getattr(builtins, type_name)
    return obj

2. 将字典保存为JSON文件 #

用自定义的编码器来序列化字典，这样生成的JSON会保留类型的标记信息：

data = { 
    'model':{ 
        'param1': tuple, 
        'param2': tuple 
    }, 
    'model2':{ 
        'param3': int, 
        'param4': bool 
    } 
}

# 保存文件，用indent参数保持格式可读性
with open('type_config.json', 'w') as f:
    json.dump(data, f, cls=TypeEncoder, indent=4)

生成的JSON文件内容会是这样的（保留了类型标记）：

{
    "model": {
        "param1": {
            "__type__": "tuple"
        },
        "param2": {
            "__type__": "tuple"
        }
    },
    "model2": {
        "param3": {
            "__type__": "int"
        },
        "param4": {
            "__type__": "bool"
        }
    }
}

3. 从JSON读取并还原类型 #

用自定义的解码器钩子来读取文件，就能把标记还原成真实的Python类型：

# 读取并还原类型
with open('type_config.json', 'r') as f:
    loaded_data = json.load(f, object_hook=type_decoder)

# 验证是否能正常使用isinstance
print(isinstance((1,2), loaded_data['model']['param1']))  # 输出 True
print(isinstance(5, loaded_data['model2']['param3']))     # 输出 True
print(isinstance(True, loaded_data['model2']['param4']))  # 输出 True

扩展说明 #

• 如果需要支持自定义类类型，只需要在编码器里添加类的路径标记，解码器里通过路径导入对应的类即可
• 这个方案完全兼容你原有的isinstance校验逻辑，导入后的字典用法和原来完全一致

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