0

0

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

冷炫風刃

冷炫風刃

发布时间:2026-01-26 16:28:02

|

831人浏览过

|

来源于php中文网

原创

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>
  • 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><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/1987" title="无限画"><img
                                                                                src="https://img.php.cn/upload/ai_manual/000/000/000/175680368552634.png" alt="无限画"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/1987" title="无限画">无限画</a>
                                                                        <p>千库网旗下AI绘画创作平台</p>
                                                                </div>
                                                                <a href="/ai/1987" title="无限画" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div><h1>→ {"s": {"<strong>set</strong>": true, "values": [1, 2]}}</h1><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,错误才冒出来。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

457

2023.08.07

json是什么
json是什么

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

549

2023.08.23

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

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

337

2023.10.13

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

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

82

2025.09.10

css中float用法
css中float用法

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

595

2024.04.28

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

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

108

2025.10.23

string转int
string转int

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

1031

2023.08.02

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

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

613

2024.08.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号