json.dumps排序键方法及自定义示例

golang学习网今天将给大家带来《json.dumps 序列化时，可以通过设置 sort_keys=True 参数对字典的键进行排序。以下是示例代码：import json data = { "b": 2, "a": 1, "c": 3 } json_str = json.dumps(data, sort_keys=True) print(json_str)输出结果：{"a": 1, "b": 2, "c": 3}说明：sort_keys=True：表示对字典的键进行排序，默认按字母顺序升序排列。如果需要自定义排序方式，可以使用 key 参数（不过 json.dumps 不支持直接传入 key，需在序列化前先对字典进行排序）。自定义排序示例：import json data = { "b": 2, "a": 1, "c": 3 } # 先按键长度排序 sorted_data = dict(sorted(data.items(), key=lambda item: len(item[0]))) json_str = json.dumps(sorted_data) print(json_str)输出结果：{"a": 1, "b": 2, "c": 3} # 如果键长度相同，会按字母顺序排序这样你就可以灵活控制 JSON 序列》，感兴趣的朋友请继续看下去吧！以下内容将会涉及到等等知识点，如果你是正在学习文章或者已经是大佬级别了，都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家！

json.dumps 的 sort_keys=True 仅对顶层字典键按字典序升序排列，不递归处理嵌套字典；默认为 False，开启后有轻微性能开销但无兼容性问题，混用键类型会报 TypeError。

json.dumps 的 sort_keys 参数怎么用

直接传 sort_keys=True 就行，这是最简单也最常用的方式。它会让输出 JSON 的键按字典序升序排列，对调试、比对或生成稳定哈希特别有用。

示例：

import json
data = {"c": 3, "a": 1, "b": 2}
print(json.dumps(data, sort_keys=True))
# 输出：{"a": 1, "b": 2, "c": 3}

注意：sort_keys 默认是 False，不设就完全不排序。

嵌套字典的键也会被递归排序吗

不会。json.dumps 的 sort_keys=True 只作用于顶层对象的键，不递归处理嵌套结构。

比如：

data = {"z": {"c": 1, "a": 2}, "a": 3}
print(json.dumps(data, sort_keys=True))
# 输出：{"a": 3, "z": {"c": 1, "a": 2}} —— 外层键排了，内层没排

如果需要全量排序，得自己预处理数据，例如写个递归函数把所有 dict 的键都转成有序形式再传给 dumps。

sort_keys 对性能和兼容性有什么影响

开启 sort_keys=True 会带来轻微性能开销，因为要对每个对象的键做排序（通常是 O(n log n)）。在高频序列化或超大字典场景下可能 noticeable，但日常使用基本无感。

• Python 3.7+ 字典本身保持插入顺序，但 sort_keys=True 会覆盖这个顺序，强制按字母排
• 所有 Python 版本都支持该参数，没有兼容性问题
• 如果键类型混杂（如 str 和 int），排序会报 TypeError，因为无法比较不同类型的键

为什么开了 sort_keys 还是没排序

常见原因有三个：

• 传入的对象不是 dict，而是其他映射类型（比如 collections.OrderedDict 或自定义类），json.dumps 不会自动对其键排序，除非它实际表现为普通 dict
• 用了 default 参数且返回值中包含未排序的 dict，排序只发生在最终组装阶段，中间态不受控
• 键里有不可排序类型，比如 None、函数、或混合类型（"a" 和 1），这时会静默失败或抛异常，取决于 Python 版本和上下文

排查时建议先用 print(type(data), list(data.keys())) 确认输入结构是否符合预期。

真正要注意的是：排序只发生在 JSON 编码那一刻，不影响原始数据；如果后续还要修改结构，别依赖 sort_keys 来“整理”你的 dict —— 它只是输出控制，不是数据清洗工具。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。