操作教學
如何線上格式化 JSON
來自 API 回應或設定檔的原始 JSON 常被壓縮成單一長行。在那種狀態下閱讀、除錯或編輯它都很痛苦。本指南示範如何三下點擊就把 JSON 美化成適當縮排、驗證它有無語法錯誤,並在需要時把它壓縮回去,一切都在你的瀏覽器中執行,沒有資料離開你的分頁。
逐步教學
- 開啟 JSON 格式化工具,把你的 JSON 貼進左側面板。你可以直接從剪貼簿(Ctrl+V)、從命令列的 curl 回應,或從任何文字編輯器貼上。在工具的上限範圍內,輸入可接受任何大小。
- 選擇模式。「格式化」會加上縮排(2 或 4 個空格,由你決定);「驗證」只檢查語法而不修改 JSON;「壓縮」會去掉所有空白以產生盡可能最小的輸出。對多數使用情境,「格式化」就是你要的。
- 點擊「執行」。格式化後的輸出會出現在右側面板。用「複製」按鈕複製它,再貼回你的編輯器或設定檔。工具會顯示行數與字元數,讓你一眼就能確認輸出大小。
解讀錯誤訊息
當你的 JSON 有語法錯誤時,格式化工具會以位置(行與列)顯示錯誤,指向那個破壞剖析的確切字元。常見的元凶:陣列或物件中最後一項之後的尾隨逗號(在 JavaScript 中有效,但在 JSON 中無效)、缺少或多出的右括號、未用雙引號包住的鍵,或字串內未跳脫的特殊字元。修正被標出的位置後再執行一次。
JSON、YAML 與 CSV:何時用哪一種
JSON 是供程式碼消費的 API 回應與設定檔的標準。YAML 較適合由人手動編輯的設定(標點較少、支援註解)。CSV 最適合供試算表消費的表格資料。本站的資料轉換器讓你一步在這三種格式之間轉換:貼上 JSON、點擊「轉換」、取出 YAML 或 CSV。當你需要把資料嵌入 URL 查詢參數,或塞進有大小限制的 HTTP 標頭時,壓縮過的 JSON 也很有用。
本指南使用的工具
常見問題
我的 JSON 會被送到任何伺服器嗎?
不會。格式化工具完全在你的瀏覽器中執行。你的 JSON 用瀏覽器原生的 JSON.parse 剖析,輸出在記憶體中建構:沒有任何東西經由網路傳輸。當 JSON 含有 API 金鑰、權杖、內部資料或個人資訊時(這在 API 除錯流程中很常見),這一點很重要。
我能貼上的最大大小是多少?
格式化工具接受最大 5 MB 的 JSON。超過之後,在主執行緒上剖析會凍結瀏覽器分頁且沒有任何回饋。對更大的 JSON 檔,請改用專門的桌面工具,例如命令列上的 jq(jq . file.json),它能毫無問題地處理數百 MB。