JSON 工具箱

工程實踐

把 JSON 放進真實系統:介面契約怎麼定、配置與夾具怎麼管、版本相容怎麼做、測試資料怎麼維護。

5 篇文章

本分類文章

JSON API 資料契約設計要點

六件事一旦上線就很難改:響應包裹、錯誤格式、分頁形態、ID 與時間的表示、null 與預設的語義、版本演進。

進階約 13 分鐘更新於 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