json.dumps 如何排序键

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 —— 它只是输出控制，不是数据清洗工具。