JSON 排序

相關推薦

什麼是 JSON 排序（JSON Sort）？

適用場景

• 統一團隊 JSON 設定檔、package.json、tsconfig.json 等的鍵名順序，減少 Git Diff 噪音
• 對比兩個 JSON 前先排序，消除鍵順序不同造成的假差異，讓 diff 聚焦在真正變更
• API 響應資料正規化鍵名順序，方便前端快取、IndexedDB 儲存、物件 hash 計算
• CI/CD 設定中心、Feature Flag 服務的設定按規範鍵序落盤，便於稽核和回滾
• 整理大型 JSON 設定檔或資料匯出檔案，按字母序排列鍵名後視覺更整齊
• 在把 JSON 寫入資料庫 / Redis / 訊息佇列前統一鍵名順序，保證下游消費冪等

使用方法

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)