什麼是 JSON?如何驗證並排除常見錯誤

從資料結構到驗證策略,建立能讀、能維護、能交換的 JSON。

什麼是 JSON?如何驗證並排除常見錯誤

JSON 是什麼

JSON(JavaScript Object Notation)是一種文字格式,常用於設定檔、API 請求與系統之間的資料交換。它容易閱讀,但格式非常嚴格:少一個逗號或多一個引號都會讓解析失敗。

核心結構

JSON 由物件、陣列與基本值組成。物件以大括號包住,鍵名必須使用雙引號;陣列以中括號包住。有效 JSON 可包含字串、數字、布林值、null、物件與陣列。

{ "user": { "name": "Lin", "active": true }, "tags": ["api", "docs"] }

最常見的驗證錯誤

  • 使用單引號,或忘記替鍵名加雙引號。
  • 最後一項後面多一個逗號。
  • 字串內有未跳脫的換行或雙引號。
  • 把 JavaScript 的 undefined、註解或函式寫進 JSON。

實用的排錯順序

先交給格式化/驗證器定位錯誤行,再由外層大括號或中括號往內檢查成對結構。確認格式有效後,才檢查欄位名稱、型別與商業規則;這三件事不應混在一起。

結論

JSON 驗證是資料品質的第一道門檻。格式正確不代表資料一定符合需求,但格式不正確時,後面的驗證根本無從開始。