JSON 排序

相关推荐

什么是 JSON 排序（JSON Sort）？

适用场景

• 前端开发把 Storybook 的 Mock JSON 排序后再写入组件 stories，避免不同故事间键顺序杂乱、story diff 噪音大。
• 后端在写 Controller 单元测试前，把 OpenAPI 生成的样例响应先排序再写进断言快照，保证 CI 上每次断言字符串完全一致。
• 数据分析师把数据库导出的订单 JSON 数组按 price 数值字段升序排序后导出 CSV，列顺序稳定便于在 Excel 里做区域筛选和对比。
• 测试工程师排查线上 bug 时，把出问题的 API 响应和正常响应分别排序后丢进 JSON Diff 工具，消除键名顺序造成的假差异，只看真变更。
• 运维翻查应用日志里 JSON 行时，先把整段粘到本工具按键名排序再 grep 关键字段（如 level、trace_id），定位更快。
• 后端在 PR 描述里贴接口返回示例时，先用本工具排序键名，避免评审人看到一坨顺序各异的字段，沟通成本更低。
• 产品经理拿到多份用户访谈记录导出的 JSON 后，先把每份的字段按固定顺序排好再合并阅读，确保跨受访者横向比较时不漏字段。
• 数据工程师把 Kafka 消费到的埋点 JSON 数组成员按 created_at 数值字段降序排后归档，落盘顺序稳定便于回放。
• 前端在把环境变量 .env.json 注入构建流水线前先递归排序键名，保证 dev/staging/prod 三套配置在内容相同时哈希一致，避免缓存击穿。
• 配置管理员把 Apollo/Nacos 配置中心导出的 JSON 文件排序后再做 Schema 校验，先让结构整齐再校验字段约束，校验报告更易读。
• 客服把聊天记录导出 JSON 数组按 send_at 数值字段升序排好，再转 YAML 喂给 LLM 做情绪分析，避免时间错乱的对话误导模型。
• 前端开发从 ChatGPT 复制的 JSON 排版混乱时，先粘进本工具排序键名再格式化为 2 空格缩进，得到整洁可提交的入参示例。
• 运维处理 Redis Cluster 导出的 .rdb 快照转 JSON 排版错乱时，先排序键名再 diff 两次备份，能快速识别到底改了哪些字段。
• 数据分析师把 MongoDB aggregate 结果导出为 JSON 数组后，用本工具按数组模式加数值类型升序排好，再丢给下游 SQL 转换工具批量入库，列顺序稳定可追溯。
• 后端在 GraphQL 多端点返回结构对齐前，把每个端点响应 JSON 分别排序后存为 fixture，前后端共用同一份规范化样本。

使用方法

1. 把需要排序的 JSON 内容粘贴到左侧输入框，或点击「示例」加载一个典型多层级 JSON，或上传 .json/.txt 文件
2. 在底部选项栏中选择排序模式：默认「按键名排序」；如需对数组内元素排序，切换到「按数组排序」
3. 根据需要切换升序 / 降序按钮，勾选或取消「递归」选项（默认开启）
4. 点击「排序」按钮，右侧输出框会显示排序后的格式化结果；点击「复制」或「下载」保存为 sorted.json

功能特点

• 两种排序模式：支持"按对象键名排序"和"按数组元素排序"两种核心模式，可一键切换
• 递归嵌套处理：默认开启递归，深入多层嵌套对象对每一层级都做键名排序，确保结构整齐一致
• 升序/降序切换：内置升序（A-Z）/ 降序（Z-A）切换按钮，灵活适配阅读习惯和业务要求
• localeCompare 字典序：键名比较使用本地字典序，对中文、特殊字符、emoji 都能正确排序
• 保留数据结构：只调整键名顺序与数组元素顺序，不增删任何字段、不修改值类型
• 示例数据快速体验：内置"动物园 + alpha/beta/omega"演示数据，一键加载即可看到排序效果
• 本地处理保护隐私：解析、排序、格式化全部在浏览器本地完成，输入内容不发送到任何服务器
• 无缝衔接下游：排序结果可一键复制到 JSON 格式化、Diff 对比、Schema 校验等工具中继续处理

代码示例

// 按键名递归排序, 返回新对象（不修改原对象）
function sortKeysDeep(value) {
  if (Array.isArray(value)) return value.map(sortKeysDeep);
  if (value !== null && typeof value === 'object') {
    return Object.keys(value)
      .sort((a, b) => a.localeCompare(b))
      .reduce((acc, k) => {
        acc[k] = sortKeysDeep(value[k]);
        return acc;
      }, {});
  }
  return value;
}

const data = { zoo: { animals: ['zebra', 'elephant'] }, alpha: 1, beta: 2 };
const sorted = sortKeysDeep(data);
console.log(JSON.stringify(sorted, null, 2));
// => {
//      "alpha": 1,
//      "beta": 2,
//      "zoo": { "animals": ["zebra", "elephant"] }
//    }

import json

data = {"zoo": {"animals": ["zebra", "elephant"]}, "alpha": 1, "beta": 2}

# 序列化时按 sort_keys 自动按字母序排
sorted_json = json.dumps(data, indent=2, sort_keys=True, ensure_ascii=False)
print(sorted_json)

# 数组按值排序
arr = [3, 1, 4, 1, 5, 9, 2, 6]
print(sorted(arr))          # 数字升序
print(sorted(arr, reverse=True))  # 降序

# 字符串字典序
print(sorted(['banana', 'Apple', 'cherry']))  # ['Apple', 'banana', 'cherry']

# 按键名递归排序 + 2 空格缩进
jq -S '.' data.json

# 解释: -S (--sort-keys) 把所有对象键按 ASCII 升序递归排序

# 数组按元素字符串字典序排序 (对象会按 JSON 字符串比较)
jq 'sort' data.json

# 数组按某个字段排序 (例如按 age 升序)
jq 'sort_by(.age)' data.json

# 降序
jq 'sort_by(.age) | reverse' data.json

常见问题

故障排查

术语表

JSON Sort

把 JSON 对象键名按字母序重排，或把数组元素按值重排；不改变任何字段值或类型，仅重排物理顺序。

localeCompare

JavaScript 内置的字符串字典序比较函数，返回 -1/0/1；本工具用 localeCompare 对键名排序，对中文/特殊字符/emoji 都能正确比较。

ASCII 升序 / 降序

按字符的 Unicode 码点（ASCII 表）排序；大写字母 A-Z 在小写字母 a-z 之前，数字 0-9 在字母之前。

locale-aware Sort

考虑语言习惯的排序；对中文默认按 Unicode 码点或浏览器 locale，与严格的 Pinyin 排序有差异。

整数键 (Integer-like Key)

看起来像非负整数的对象键名（如 "0"、"1"、"2"），JavaScript 引擎会自动按数字升序迭代；规范行为，不可关闭。

递归排序 (Recursive Sort)

对嵌套对象的每一层级都做键名排序；本工具默认开启，关闭后只排最外层。

Canonical Form

规范化形式；JSON 排序是构造 canonical form 的一种手段，便于 diff、缓存 hash、跨环境一致。

Git Diff 噪音

代码 review 中由格式差异（而非真实逻辑变更）产生的 diff 行；键名顺序不同的 JSON 提交会大量产生噪音 diff。

pre-commit Hook

Git 提交前自动执行的钩子脚本；很多团队在 pre-commit 里调用 `jq -S .` 把 JSON 文件键名排序后再 add，保证仓库内 JSON 顺序一致。

JSON Diff 工具

对比两个 JSON 找出差异的工具（如 jsondiffpatch）；建议先对两边 JSON 排序再 diff，能消除键名顺序造成的假差异。

JSON 排序场景与排序方法对照表

JSON 排序 vs JSON Diff vs JSON Merge

Authoritative References

• MDNArray.prototype.sort - MDN Web 文档
• jqjq 官方手册 - sort / sort_by
• PythonPython json.dumps sort_keys 参数
• IETFJSON 官方规范 (RFC 8259)