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