Python含元组的字典转美观JSON报错问题求助

这个问题我之前踩过坑！核心原因很明确：JSON规范要求对象的键必须是字符串类型，而你的字典用了元组作为键，直接调用json.dumps()肯定会抛出类型错误。至于你说的转成字符串只能得到单行结果，那是因为没用到JSON模块的格式化参数。下面给你两种实用的解决办法：

方法一：手动转换元组键为字符串后格式化输出 #

最简单直接的方式是先遍历字典，把每个元组键转换成可读性强的字符串，再用json.dumps()的indent参数生成美观的多行格式。

举个具体例子：

import json

# 你的原始字典（元组作为键）
my_dict = {('Alice', 25): 100, ('Bob', 30): 200, ('Charlie', 28): 150}

# 将元组键转为字符串格式（比如"(Alice, 25)"）
formatted_dict = {str(key): value for key, value in my_dict.items()}

# 用indent参数生成缩进的美观JSON，sort_keys可选用来排序键
print(json.dumps(formatted_dict, indent=4, sort_keys=True))

输出结果会是清晰的多行格式：

{
    "(Alice, 25)": 100,
    "(Bob, 30)": 200,
    "(Charlie, 28)": 150
}

如果默认的str(tuple)格式不符合你的需求，还可以自定义键的格式，比如用下划线拼接：

def tuple_to_key(tuple_key):
    return "_".join(str(item) for item in tuple_key)

formatted_dict = {tuple_to_key(key): value for key, value in my_dict.items()}

这样键会变成"Alice_25"这种更简洁的形式。

方法二：自定义JSON编码器（更灵活） #

如果你的字典结构复杂，或者不想手动转换字典，可以自定义一个JSON编码器类，让它自动处理元组键的序列化：

import json

class TupleKeyJSONEncoder(json.JSONEncoder):
    def encode(self, obj):
        # 若对象是字典，先将所有元组键转为字符串
        if isinstance(obj, dict):
            processed_dict = {str(key): value for key, value in obj.items()}
            return super().encode(processed_dict)
        # 其他类型按默认逻辑处理
        return super().encode(obj)

# 使用自定义编码器，加上indent参数格式化
print(json.dumps(my_dict, cls=TupleKeyJSONEncoder, indent=4))

这种方式的好处是扩展性强，以后如果需要处理其他非JSON原生支持的类型，直接在编码器里添加逻辑即可。

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