JSON 比對工具

貼上兩份 JSON,看清楚哪裡改了。 不用先設定:換個比法會更清楚時,畫面會提示你。

三個步驟

  1. 左邊貼上原始的 JSON。
  2. 右邊貼上修改後的 JSON。
  3. 差異會自動顯示在這裡。

怎麼使用

  1. 貼上兩份資料

    左邊放原始版本,右邊放修改後的版本。可以貼上、直接輸入,或把 .json 檔案拖到任一邊。 沒有「比對」按鈕:一邊輸入,結果一邊更新。

  2. 看差異清單

    每一列是一個差異:發生了什麼事(新增、刪除、修改),以及在哪裡。 點一下那一列,就會跳到「左右並排」裡對應的位置。

  3. 跟著提示走

    如果項目只是換了位置,或是時間欄位造成一堆干擾,會出現藍色提示,建議更適合的比法。按一下就套用,再按一下就取消。

看懂比對結果

第一次用也沒關係。下面說明畫面上每個詞的意思。

什麼是 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 筆,按「複製清單」可以拿到全部。兩份文件有幾千行不同時,左右並排會關掉,只留下清單。