登录
首页 >  文章 >  python教程

要使用 json.dumps() 自定义序列化 set 或 frozenset,可以通过自定义 default 函数来实现。以下是一个示例:import json def default(o): if isinstance(o, set): return list(o) elif isinstance(o, frozenset): return l

时间:2026-05-21 21:38:22 113浏览 收藏

Python 的 `json.dumps()` 默认无法序列化 `set` 和 `frozenset`,但通过轻量灵活的 `default` 参数自定义转换函数(如转为有序或无序列表),即可轻松解决;若需保留集合语义并显式标识类型,还可继承 `JSONEncoder` 构建带元信息的结构;不过务必注意无序性、无限递归风险及深层嵌套中未处理集合的“隐藏陷阱”——实际应用中,预处理全量数据往往比依赖 `default` 更可靠。

json.dumps() 如何自定义序列化 set / frozenset

json.dumps() 默认不支持 set / frozenset

直接传 setfrozensetjson.dumps() 会报 TypeError: Object of type set is not JSON serializable。JSON 标准本身没有对应集合的类型,Python 的 json 模块默认只认 dictliststrintfloatboolNone

用 default 参数把 set 转成 list

最常用、最轻量的做法是通过 default 参数提供一个回调函数,对不认识的类型做转换:

import json
<p>def json_default(obj):
if isinstance(obj, (set, frozenset)):
return list(obj)
raise TypeError(f"Object of type {type(obj).<strong>name</strong>} is not JSON serializable")</p><p>data = {"tags": {"python", "web", "api"}, "readonly": frozenset([1, 2, 3])}
json_str = json.dumps(data, default=json_default, sort_keys=True)</p><h1>→ {"readonly": [1, 2, 3], "tags": ["api", "python", "web"]}</h1><p></p>
  • default 函数只在遇到无法序列化的对象时被调用,不影响其他类型
  • 返回 list(obj) 是安全的,但注意:set 无序,转成 list 后顺序不保证(如需稳定顺序,可加 sorted()
  • 不要在 default 中返回原始 obj 或递归调用 json.dumps(),否则会无限循环

需要保持集合语义?考虑自定义 encoder 类

如果下游解析器能配合改造,想显式区分“这是个集合”,可以继承 json.JSONEncoder 并重写 encodedefault

class SetEncoder(json.JSONEncoder):
    def default(self, obj):
        if isinstance(obj, set):
            return {"__set__": True, "values": list(obj)}
        if isinstance(obj, frozenset):
            return {"__frozenset__": True, "values": list(obj)}
        return super().default(obj)
<p>json.dumps({"s": {1, 2}}, cls=SetEncoder)</p><h1>→ {"s": {"<strong>set</strong>": true, "values": [1, 2]}}</h1><p></p>
  • 这种格式增加了元信息,但要求解析端也识别 __set__ 字段并还原
  • 不能和 default 参数混用(cls 优先级更高)
  • 若数据里还有其他自定义类型,记得在 default 末尾调用 super().default(obj),否则会丢弃默认行为

注意嵌套结构和不可哈希元素

set 里如果包含不可 JSON 序列化的对象(比如另一个 set、函数、或自定义类实例),仅靠上面的 default 还不够:

  • {1, {2, 3}} 会失败,因为内层 set 在外层 list(obj) 时才触发序列化,但此时已脱离 default 控制范围
  • 正确做法是确保 default 能递归处理——但 json.dumps() 不提供递归钩子,所以得手动扁平化或预处理
  • 更稳妥的方式是:在调用 json.dumps() 前,用递归函数把所有 set/frozenset 替换为 list,再 dump

真正容易被忽略的是:你以为只改了顶层 set 就万事大吉,结果数据嵌套三层后某个字典的值仍是未处理的 frozenset,错误才冒出来。

今天关于《要使用 json.dumps() 自定义序列化 set 或 frozenset,可以通过自定义 default 函数来实现。以下是一个示例:import json def default(o): if isinstance(o, set): return list(o) elif isinstance(o, frozenset): return list(o) raise TypeError(f"Object of type {type(o)} is not JSON serializable") data = { "my_set": {1, 2, 3}, "my_frozenset": frozenset([4, 5, 6]) } json_str = json.dumps(data, default=default) print(json_str)输出:{"my_set": [1, 2, 3], "my_frozenset": [4, 5, 6]}说明:default 函数会在 json.dumps() 遇到无法序列化的对象时被调用。你可以根据需要将 set 或 frozenset 转换为 list 或其他可序列化的类型。如果你希望保留集合的唯一性,也可以选择返回元组或其他结构。可选优化:如果你希望统一处理所有不可序列化的对象,可以扩展 default 函数: def default(o): if isinstance(o, (set, frozens》的内容就介绍到这里了,是不是学起来一目了然!想要了解更多关于的内容请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>