工程實踐
把 JSON 放進真實系統:介面契約怎麼定、配置與夾具怎麼管、版本相容怎麼做、測試資料怎麼維護。
5 篇文章本分類文章
兩份 JSON 差在哪:按位置比、按 id 比,還是先正規化
50 筆資料插進 1 筆,為什麼比對工具報了 51 處差異?講清文字 diff 在 JSON 上的三類誤報、陣列按位置與按 id 的取捨、jq 正規化指令,以及比出差異後怎麼變成可套用的修補檔。
入門約 6 分鐘更新於 2026-10-30
JSON 檔案的 Git 衝突:union 會寫出壞 JSON,按 key 合併才對
兩個分支各加一個文案鍵,Git 卻報衝突,於是有人加上 merge=union 一行了事。實測下來,union 會讓缺逗號的 JSON 通過合併、讓重複鍵靜默覆蓋、讓單行 JSON 變成兩份文件,而 Git 全程認為「合併成功」。這篇給出按 key 三方合併的驅動寫法,以及三個能讓衝突變少的前置習慣。
進階約 7 分鐘更新於 2026-10-30
JSON 契約的版本演進:相容、棄用與資料遷移
替介面加欄位不等於安全,破壞性變更往往藏在型別與語義裡。這篇給出可執行的版本演進路徑:相容邊界、版本欄位與媒體型別、棄用視窗、消費者排查、雙寫遷移與還原、契約測試,以及漸進式發佈的觀察指標。
實戰約 10 分鐘更新於 2026-10-31




