JSON 比對工具
貼上兩份 JSON,看清楚哪裡改了。 不用先設定:換個比法會更清楚時,畫面會提示你。
三個步驟
- 左邊貼上原始的 JSON。
- 右邊貼上修改後的 JSON。
- 差異會自動顯示在這裡。
怎麼使用
貼上兩份資料
左邊放原始版本,右邊放修改後的版本。可以貼上、直接輸入,或把 .json 檔案拖到任一邊。 沒有「比對」按鈕:一邊輸入,結果一邊更新。
看差異清單
每一列是一個差異:發生了什麼事(新增、刪除、修改),以及在哪裡。 點一下那一列,就會跳到「左右並排」裡對應的位置。
跟著提示走
如果項目只是換了位置,或是時間欄位造成一堆干擾,會出現藍色提示,建議更適合的比法。按一下就套用,再按一下就取消。
看懂比對結果
第一次用也沒關係。下面說明畫面上每個詞的意思。
- 什麼是 JSON 比對?
JSON 是程式之間傳遞資料常用的格式,長得像 {"name":"Ann","age":30}。比對就是找出兩份資料哪裡不一樣,例如 API 改版前後的回應,或兩個環境的設定檔。
這個工具比的是「資料」,不是「文字」。空白、換行、欄位的先後順序不同,都不算差異。
- 路徑怎麼讀?
每個差異前面都有一串像 $.users[0].email 的文字,它是那個值的「地址」:
- $ 代表整份資料
- .users 代表名叫 users 的欄位
- [0] 代表清單裡的第 1 個項目(從 0 開始數)
- .email 代表那個項目裡的 email 欄位
合起來就是「users 清單第 1 個項目的 email」。
- 新增、刪除、修改
- 新增(綠色):右邊有,左邊沒有。
- 刪除(紅色):左邊有,右邊沒有。
- 修改(黃色):兩邊都有,但值不一樣,會顯示「舊值 → 新值」。
- 移動
清單裡的項目換了位置,但還是同一筆。只有在清單「依欄位」比對時才會出現。
- 型別改變
值的種類變了,例如數字 1 變成加了引號的文字 "1"。兩個看起來很像,但程式會當成不同的東西,常常是出錯的原因,所以特別標出來。
每個值旁邊會標出它的型別,用的是 JSON 和大多數程式語言通用的英文名稱:
- string:字串,加引號的文字,例如 "hello"
- number:數字,例如 42 或 3.14
- boolean:布林值,只有 true 或 false
- null:沒有值
- object:物件,大括號包起來的一組欄位,例如 {"a":1}
- array:陣列,中括號包起來的清單,例如 [1,2,3]
- 藍色的提示是什麼?
當「換個比法,很多差異就能解釋」時會出現:清單只是順序換了、數字只是寫法不同(1 和 1.0),或某個欄位每次都會變(時間、編號)。
按提示上的按鈕就會套用,畫面下方會出現「復原」可以馬上取消。結果上方會出現一個小標籤說明目前用了什麼,按標籤上的 × 也能取消。不理提示也沒關係:預設是最嚴格的比法,不會漏掉任何差異。
- 很多列看起來一樣?
同一個欄位在很多項目都變了(例如 100 個商品的價格),會收成一列,看起來像疊在一起的卡片,並先列出一個例子。按右邊的「展開 N 筆」才看每一筆。
- 輸入框變紅了?
表示那一邊還不是正確的 JSON。下方會說明第幾行、哪裡有問題。改好之後才會開始比對,這樣你接著拿去用的資料一定是正確的。
- 小技巧
- 輸入框的行號會上色,標出差異在你貼的內容的哪一行:紅色是刪除、綠色是新增、黃色是修改。
- JSON 擠在一行很難讀?按那一邊上方的「排版」就會整理好,比對結果不會變。
- 在清單點路徑,就會跳到左右並排的那一行;在左右並排裡按 J、K 可以跳到下一個、上一個差異。
- 資料很大時要等一下,畫面會顯示「比對中…」,表示正在處理,你可以繼續輸入。
- 選項會記在這個瀏覽器,下次打開還在(不會記你貼的內容)。結果上方的標籤會一直顯示目前用了哪些選項。
常見問題
我的 JSON 會被上傳嗎?
不會。 兩份文件都在你的瀏覽器裡比對,頁面不會把你貼上的內容傳到任何伺服器。
- 沒有「線上儲存」或分享連結,你的資料不會意外出現在公開網址上。
- 你貼上的內容不會被保存,連瀏覽器裡也不會;只有比對選項(例如要忽略的欄位)會記在你的瀏覽器裡。
- 頁面載入後就算中斷網路,也能繼續使用。
鍵的順序或空白會算成差異嗎?
不會。{"a":1,"b":2} 和 {"b":2,"a":1} 的內容一樣,縮排怎麼寫也沒關係,都算相同。 如果內容一樣、只是寫法不同,頁面會另外告訴你。
清單(陣列)是怎麼比對的?
預設照順序一項一項比,因為在 JSON 裡清單的順序是有意義的。中間加了或刪了一項時,只會顯示那一項,例如在最前面加一項,只會顯示「新增一項」,後面的項目不會全部變成「修改」。項目裡的內容有改時,清單會指出位置,例如 $.items[3].price。
「比對選項」裡還有兩種比法:
- 依欄位:某個欄位(例如 "id")的值一樣,就當成同一個項目,不管它排在第幾個。換了位置的項目會標成「移動」,裡面有改的地方也會一起列出。可以用的欄位會從你的文件自動找出來,也可以自己輸入。
- 不管順序:完全不看項目的順序,適合標籤、權限這類清單。
如果有些差異看起來只是項目換了位置,頁面會提示你可以改用哪一種比法。
怎麼忽略時間這類每次都會變的欄位?
有改到的欄位如果看起來是時間或編號,頁面會問你要不要忽略。你也可以在「比對選項」裡自己寫,一行一個:
- updatedAt:所有叫這個名字的欄位,不管在哪一層
- meta.requestId:所有 meta 底下的 requestId
- $.items[*].updatedAt:只有這個位置;[*] 代表清單裡的每一項
忽略的欄位兩邊都不會比,結果上方會標出目前忽略了哪些。
1 和 1.0 算一樣嗎?
預設不算。數字照原本的寫法比,這樣才不會漏掉任何差異。如果有些差異只是寫法不同,頁面會告訴你有幾個,並讓你改成「數字依數值比較」,這時 1、1.0、1e0 都算相同。
不管用哪一種,很長的數字都不會被四捨五入:12345678901234567890 和 12345678901234567891 一定算不同。用 JavaScript 內建的 JSON.parse 讀取的工具會把這種數字四捨五入,可能把它們當成一樣。 加了引號的 "1" 是文字,不是數字,所以和 1 比會標成「型別改變」。
其中一份文件有錯誤怎麼辦?
要先改好才會比對。輸入框會變紅、標出那一行,並說明錯在哪裡,例如 } 前面多了逗號,或用了單引號而不是雙引號。
這裡不會自動幫你修。如果工具偷偷修好,再告訴你「沒有差異」,你可能會繼續拿著別的程式讀不了的檔案去用。JSON 格式化工具能修的錯誤,旁邊會出現連到它的連結;它會修正並列出每一個改動。
文件可以多大?
幾 MB 的文件也可以比。所有差異都會找出來(重複的會合成一組);清單最多顯示前 1000 筆,按「複製清單」可以拿到全部。兩份文件有幾千行不同時,左右並排會關掉,只留下清單。