JSON 智慧對比
左右雙欄 · 增刪改高亮 · 文字/視覺化
智慧對比
就緒
ABOUT
關於 JSON 智慧對比
對比兩段 JSON 的結構與內容差異，支援視覺化高亮和文字報告兩種模式，幫助快速發現 API 響應變更。
版本發布前核對 API 契約、排查配置漂移、驗證 Mock 資料更新——Diff 是開發者最高頻的 JSON 操作之一。JSONSort 在本地完成對比，兩份資料都不會離開你的裝置。
DEEP DIVE
深入瞭解 JSON 智慧對比
API 版本迭代、配置熱更新、A/B 測試迴歸——開發者經常需要回答「這兩份 JSON 到底哪裡不同」。純文字 diff 對 JSON 不友好：欄位順序變化、縮排差異都會產生大量噪音。JSONSort 智慧對比按 JSON 結構語義比較，增刪改高亮清晰可讀。
工具提供視覺化雙欄 Diff 和純文字報告兩種輸出。視覺化模式適合快速瀏覽，文字報告適合貼上到 Pull Request 描述或 Jira 工單中留檔。
對比演算法基於解析後的 JSON 抽象語法樹，而非逐行文字 diff。這意味著單純調整縮排或鍵順序不會產生誤報；真正的新增、刪除與值變更才會高亮顯示，適合作為 Code Review 與發布 checklist 的輔助工具。
FEATURES
核心能力
左右雙欄輸入
左側為基準版本，右側為對比版本，符合直覺的操作佈局。
視覺化高亮
新增欄位綠色、刪除紅色、修改黃色，結構變化一目瞭然。
文字 Diff 報告
可切換為純文字 diff 輸出，方便複製到文件或 IM。
結構語義對比
按 JSON 鍵值語義比較，減少無意義的空白/順序噪音。
本地執行
兩份 JSON 均不上傳，適合對比含敏感資料的介面響應。
即時重新整理
任一側輸入變化後自動重新對比，無需手動點選按鈕。
Summary 摘要
輸出變更統計與路徑級摘要，便於寫入 PR 描述。
雙模式切換
視覺化與文字報告一鍵切換，滿足不同協作習慣。
HOW TO USE
使用步驟
-
1
在左右兩欄分別貼上 JSON
-
2
選擇視覺化或文字 Diff 模式
-
3
檢視高亮差異並複製報告
-
4
在頂部選項欄調整縮排、JSON5、排序等高階設定
-
5
一鍵複製結果，或繼續用 Diff / 路徑提取等工具深入分析
WORKFLOW
典型工作流
從匯入資料到匯出結果的完整流程，幫助團隊統一 JSON 智慧對比 的使用方式。
準備兩份 JSON
左側放基準版本（舊介面/生產配置），右側放待對比版本。
預格式化
可選：兩側分別格式化，減少因空白導致的閱讀干擾。
選擇 Diff 模式
快速瀏覽用視覺化；需要留檔用文字報告。
確認變更
根據高亮逐項確認是否為預期變更，複製 summary 到 PR。
USE CASES
適用場景
後端開發
Review API v1 → v2 響應結構變更，確認欄位廢棄與新增。
測試工程師
迴歸測試時對比實際返回與預期 JSON 的差異。
DevOps
對比兩次部署之間的 ConfigMap JSON 配置變化。
前端開發
Mock 資料更新後，Diff 確認哪些欄位影響元件渲染。
API 產品
對比文件範例與真實介面返回，確保文件與實現一致。
配置管理員
發布前後對比 Nacos / Apollo 匯出的 JSON 配置差異。
TIPS
使用技巧
- 對比前先分別用格式化工具整理兩份 JSON，Diff 結果更乾淨。
- 大型 JSON 建議先去掉不關心的欄位（用合併清理工具），再對比核心部分。
- 文字報告模式輸出的 summary 可直接作為 changelog 素材。
- 陣列元素按索引比較，若只關心集合內容不關心順序，需先做排序預處理。
- 視覺化模式下左右兩欄可獨立滾動，方便對照同一層級的欄位。
- 介面聯調時，把 Postman 兩次響應分別貼上左右欄，秒級出 diff。
- 對比 v1/v2 介面時，建議先分別儲存為檔案便於反覆 Diff。
- 僅關心部分欄位時，可先用路徑提取取出子樹再對比。
- 文字報告適合 attach 到 Slack / 飛書工單作為變更記錄。
- 兩側 JSON 大小懸殊時，先確認是否拿錯了環境的資料。
LOCAL VS ONLINE
本地 vs 線上工具
JSONSort 堅持純前端架構，以下對比說明為何本地化工具更適合處理開發資料。
TROUBLESHOOTING
常見誤區與排查
實際使用中容易遇到的問題及建議處理方式，減少反覆試錯的時間。
Diff 結果噪音過多
建議：兩側先格式化並按鍵排序；或刪除 timestamp 等必然變化的欄位。
陣列元素對不上
建議：陣列按索引對比，若只關心集合內容需先排序或提取 id 對映。
一側解析失敗
建議：先用格式化工具修復語法錯誤，確保兩側均為合法 JSON。
看起來一樣但有差異
建議：檢查 hidden 欄位型別差異（字串 "123" vs 數字 123）。
FAQ
常見問題
陣列順序不同算差異嗎？
會按索引位置逐元素對比，順序變化會顯示為修改或增刪。
能對比 JSON 和 JSON5 嗎？
可以。兩側輸入獨立解析，解析成功後按 JSON 結構對比。
視覺化 Diff 能匯出嗎？
文字報告模式下的 summary 和 diff 內容可複製匯出。
左右兩側必須都是合法 JSON 嗎？
是的。若任一側語法錯誤，會先提示解析失敗及錯誤行。
浮點數精度差異算變更嗎？
會。0.1 + 0.2 等浮點表示差異會如實顯示，必要時先做數值歸一化。
能否忽略某些欄位？
當前全量對比。可先手動刪除不關心的鍵，或用合併工具預處理。
資料會上傳到伺服器嗎？
不會。JSONSort 所有工具均在瀏覽器本地執行，您的輸入內容不會傳送到任何後端伺服器。
需要註冊或安裝嗎？
不需要。開啟頁面即可使用，無需賬號、無需下載客戶端，也支援 PWA 離線快取。
支援多大的檔案？
取決於瀏覽器記憶體，通常可流暢處理數 MB 級別的資料。超大檔案建議先拆分或使用合併清理工具。