告訴你哪裡出錯的 JSON 格式化工具
這款免費的 JSON 格式化工具會將一大段壓縮資料轉換成易讀、具縮排的 JSON,同時進行檢查。貼上 API 回應、設定檔或日誌行,一次獲得三項功能:會指出第一個錯誤所在確切行號與欄號的 JSON 驗證器、支援 2 個空格、4 個空格或 Tab 縮排的 JSON 美化工具,以及在需要精簡版本時使用的壓縮工具。樹狀檢視、鍵值排序、JSON Schema 驗證及 JSON 轉 CSV,只需按一下即可使用。
所有操作都在你的瀏覽器中執行。這項工具使用自己的小型剖析器,而不是將你的資料傳送至伺服器;因此它能用淺白的文字解釋錯誤,也因此像權杖、客戶資料或內部設定等私密資料都不會離開你的裝置。
如何閱讀 JSON 錯誤訊息
大多數 JSON 錯誤並不在剖析器停止的位置,而是在那之前。當驗證器顯示 第 3 行,第 9 欄:在「}」前有尾隨逗號,它會顯示帶有指標符號指向問題字元的那一行,讓你看見不應該出現的逗號。幾種模式就能涵蓋大多數現實情況:
-
尾隨逗號。 JavaScript 允許
[1, 2,];JSON 不允許。請移除最後的逗號。 -
單引號或未加引號的鍵。
{name: 'Ann'}是 JavaScript 物件,不是 JSON。鍵和值都需要使用雙引號:{"name": "Ann"}。 -
註解。 JSON 不支援註解。像 tsconfig.json 這類檔案之所以接受註解,是因為它們的工具使用較寬鬆的格式,但嚴格的 JSON 剖析器會拒絕
//和/* */。 -
缺少逗號或括號。 如果錯誤出現在屬性的開頭,請查看它上方那一行的結尾。如果錯誤是「輸入意外結束」,表示某處缺少結尾的
}或]。 -
Python 或 JavaScript 值。
True、None、NaN和undefined都不是 JSON。請使用true、null或數字。 -
彎引號。 從文書處理器或聊天應用程式複製的文字,通常包含看起來幾乎與
"相同的排版引號。
「修正常見錯誤」按鈕會一次修復註解、單引號、未加引號的鍵、尾隨逗號、彎引號和 Python 風格的值,並列出它所變更的內容,讓你可以檢查結果,而不是盲目信任它。
大數字與重複的鍵
JSON 本身對數字沒有大小限制,但 JavaScript 會將它們儲存為 64 位元浮點數。像這樣的 ID 12345678901234567890 變成 12345678901234567000 之後 JSON.parse。此格式化工具會完全按照你輸入的方式保留每個數字,並在值大於 2^53 時提出警告,表示該值應以字串傳遞。它也會標示重複鍵:JSON 標準並未禁止重複鍵,但多數解析器會悄悄只保留最後一個,因而掩蓋錯誤。
JSON Schema 驗證簡介
JSON 驗證器會檢查語法。JSON Schema 會檢查含義:哪些欄位為必填、每個欄位的型別,以及允許哪些值。簡單的結構描述如下:
{"type": "object", "required": ["id", "email"],
"properties": {"id": {"type": "integer", "minimum": 1},
"email": {"type": "string", "format": "email"}}}
JSON Schema 分頁支援 draft 2020-12 的核心功能:types、enum 和 const、數字與字串限制、pattern、常見格式(email、date、date-time、uri、uuid、ipv4、hostname)、properties、required、additionalProperties、patternProperties、items 和 prefixItems、uniqueItems、contains、allOf、anyOf、oneOf、not、if/then/else,以及區域 $ref 連結至 $defs。每個錯誤都會顯示實例路徑,例如 $.users[1].email,以及驗證失敗的結構描述路徑。工具不會評估的關鍵字(例如 unevaluatedProperties)會列出來,而不是被悄悄忽略。如果你還沒有結構描述,可以先從範例文件產生初稿,再手動加以收緊。
為整個 API 撰寫結構描述是更大的工作。如果網頁上也需要結構化資料,結構化資料標記驗證器會檢查搜尋引擎使用的 JSON-LD,這是另一種結構描述。
JSON 與 CSV 互相轉換
試算表需要列和欄。轉換器會接收物件陣列,使用所有鍵的聯集作為標題,將巢狀物件扁平化為 dot.notation 欄位,並將陣列以 JSON 文字形式保留在單一儲存格中。以 =、+ 或 @ 開頭的值會加上前置單引號,避免試算表將其當作公式執行。反過來,貼上含標題列的 CSV:系統會偵測分隔符號,處理含逗號和換行的引號欄位,將數字和 true/false 解析為對應型別,並將 address.city 標題再次轉換為巢狀物件。若要撰寫產生這些資料的查詢,請試用 SQL 查詢產生器或 Excel 公式產生器。
每天處理 JSON 的小提示
- 除錯前先驗證。半數「API 故障」工單都是因為請求本文中少了一個逗號。
- 比較兩份文件前先排序鍵。如此一來,差異工具顯示的就是真正的變更,而不是欄位順序重新排列。
- 為傳輸而縮小,為人類而格式化。空白在 JSON 中沒有意義,因此兩個版本包含相同的資料。
- 不要將機密資料放入共用的格式化工具。會上傳資料的線上工具可能讓權杖和個人資料面臨風險;此工具不會上傳任何資料。
開發者和團隊還可以在免費 AI 產生器與工具頁面找到更多免費工具,其中包括一個用於產生消費 JSON 的程式碼的測試案例產生器。
常見問答
這個 JSON 格式化工具免費且重視隱私嗎?
有。免費使用、不需註冊,也沒有使用限制。格式化、驗證和轉換都會在你的瀏覽器中以純 JavaScript 執行,因此你的 JSON 絕不會上傳、記錄或儲存在伺服器上。
JSON 格式化工具和 JSON 驗證器有什麼不同?
格式化工具(或美化工具)會加入縮排和換行,讓 JSON 更容易閱讀。驗證器會檢查文字是否遵循 JSON 規則,並回報第一個錯誤。此工具會同時執行這兩項功能,並提供錯誤所在的確切行號和欄號。
為什麼我的 JSON 因為結尾逗號或單引號而失敗?
JSON 比 JavaScript 更嚴格。它不允許最後一個項目後面有逗號、使用單引號的字串、未加引號的鍵或註解。使用「修正常見錯誤」按鈕即可自動修復這些問題,然後檢查變更內容。
格式化工具會變更我的數字或鍵的順序嗎?
不會。數字會完全按照原本的寫法保留,即使是大於 JavaScript 可儲存範圍的 ID 也一樣;除非你啟用「按 A-Z 排序鍵」,否則鍵會保持原本的順序。
支援哪個 JSON Schema 版本?
此工具會驗證 JSON Schema draft 2020-12 的核心功能,包括類型、required、properties、enum、字串與數字限制、格式、items、prefixItems、allOf、anyOf、oneOf、not、if/then/else 和本地 $ref。它不會評估的關鍵字會列出來,而不是默默忽略。
