如何使用JSON 格式化
- 把 JSON 貼到「輸入 JSON」框,或按「載入範例」看看效果。
- 選擇「格式化」或「壓縮」,格式化時可再選 2 空格、4 空格或 Tab 縮排。
- 需要固定順序時勾選「依鍵名排序」,所有層級的物件鍵名都會依字母排列。
- 下方提示會顯示驗證結果;若有錯誤,會標出行、欄與錯誤位置。
- 按「複製結果」或「下載 .json」帶走輸出內容。
JSON 的基本語法規則
JSON(JavaScript Object Notation)是 RFC 8259 定義的資料交換格式,只有六種值:物件 {}、陣列 []、字串、數字、true/false 與 null。物件的鍵名必須是以雙引號包住的字串,鍵與值以冒號分隔,成員之間以逗號分隔。最上層可以是任何一種值,不一定要是物件。
JSON 比 JavaScript 物件寫法嚴格得多:不能用單引號、鍵名不能省略引號、最後一個成員後面不能有多餘逗號,也不支援註解、undefined、NaN、Infinity 與十六進位數字。字串中的換行要寫成 \n,Tab 要寫成 \t。
最常見的 JSON 錯誤
從程式碼或設定檔複製出來的內容,最常見的問題是結尾多一個逗號、用了單引號,或夾帶 // 註解。從網頁或通訊軟體複製時,雙引號可能被自動換成全形或彎引號(“ ”),看起來很像但 JSON 無法辨識。另外,少了一個逗號或括號沒有成對,也是長資料中常見的錯誤。
本工具會用自己的解析器重新掃描一次,把錯誤換成中文說明並顯示所在的行、欄,再把該行內容與指示箭頭列在下方,方便你在原始檔案中找到問題。錯誤位置是「解析器第一次無法繼續的地方」,實際原因有時在前一行,例如上一行少了逗號;若錯誤指向最後一行,通常代表前面某處的括號或引號沒有關閉。
格式化、壓縮與排序的用途
格式化(又稱美化、Pretty Print)會加入縮排與換行,適合閱讀 API 回應、除錯與 code review。壓縮則移除所有不必要的空白,讓檔案最小,適合放進設定值、網址參數或網路傳輸。兩者內容完全相同,只差在空白字元。在開發者工具中看到擠成一行的 API 回應,貼進來格式化後就能看清楚巢狀結構。
依鍵名排序可以讓兩份內容相同但順序不同的 JSON 輸出成一樣的結果,搭配文字比對工具就能快速找出差異。要注意的是,JavaScript 會把看起來像整數的鍵名(例如 "1"、"20")固定排在最前面,這是語言本身的規則。排序不會改變任何值,陣列中的元素順序也會維持原樣。
常見問題
貼上的 JSON 會被上傳嗎?
不會。驗證、格式化與壓縮都在你的瀏覽器中完成,資料不會傳送到任何伺服器,可以放心處理含有個人資料或金鑰的內容,但仍建議避免在公用電腦上操作。
為什麼很大的數字格式化後變了?
瀏覽器以 64 位元浮點數處理 JSON 數字,超過 9007199254740991(2 的 53 次方減 1)的整數會失去精度。訂單編號、雪花 ID 這類長整數建議在 JSON 中以字串表示。
JSON 可以加註解嗎?
標準 JSON 不支援註解。如果需要註解,可以改用 JSONC、JSON5 或 YAML 等格式,或在資料中加一個例如 "_comment" 的欄位來說明。
縮排要用 2 個空格還是 4 個?
兩者都正確,只是習慣不同。JavaScript 與前端專案多用 2 個空格,Python 的 json.dumps 範例常見 4 個空格。團隊內統一即可。
最後更新: