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

千明同学_6119

千明同学_6119

2026-01-26

911人浏览

原创

json.dumps()默认不支持set/frozenset,需通过default参数或自定义JSONEncoder处理;default最轻量,但需注意无序性、无限循环及嵌套未处理问题。

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

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

直接传 set 或 frozenset 给 json.dumps() 会报 TypeError: Object of type set is not JSON serializable。JSON 标准本身没有对应集合的类型,Python 的 json 模块默认只认 dict、list、str、int、float、bool 和 None。

用 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 并重写 encode 或 default:

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><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill10340" title="arcgis-js"><img
														src="https://img.php.cn/upload/skill/001/246/273/6adaf20e352aa140.jpg" alt="arcgis-js" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill10340" title="arcgis-js" class="overflowclass">arcgis-js</a>
													<p class="overflowclass">提供 ArcGIS Maps SDK for JavaScript 开发辅助,涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill10340" title="arcgis-js" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><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,错误才冒出来。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2235

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3602

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1196

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4139

7

css中float用法
css中float用法

css中float属性允许元素脱离文档流并沿其父元素边缘排列,用于创建并排列、对齐文本图像、浮动菜单边栏和重叠元素。想了解更多float的相关内容,可以阅读本专题下面的文章。

2024.04.28

7207

8

C++中int、float和double的区别
C++中int、float和double的区别

本专题整合了c++中int和double的区别,阅读专题下面的文章了解更多详细内容。

2025.10.23

844

4

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

7039

3

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.29

3365

6

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.29

4408

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程