什麼是 JSON?如何驗證並排除常見錯誤
從資料結構到驗證策略,建立能讀、能維護、能交換的 JSON。
JSON 是什麼
JSON(JavaScript Object Notation)是一種文字格式,常用於設定檔、API 請求與系統之間的資料交換。它容易閱讀,但格式非常嚴格:少一個逗號或多一個引號都會讓解析失敗。
核心結構
JSON 由物件、陣列與基本值組成。物件以大括號包住,鍵名必須使用雙引號;陣列以中括號包住。有效 JSON 可包含字串、數字、布林值、null、物件與陣列。
{ "user": { "name": "Lin", "active": true }, "tags": ["api", "docs"] }最常見的驗證錯誤
- 使用單引號,或忘記替鍵名加雙引號。
- 最後一項後面多一個逗號。
- 字串內有未跳脫的換行或雙引號。
- 把 JavaScript 的
undefined、註解或函式寫進 JSON。
實用的排錯順序
先交給格式化/驗證器定位錯誤行,再由外層大括號或中括號往內檢查成對結構。確認格式有效後,才檢查欄位名稱、型別與商業規則;這三件事不應混在一起。
結論
JSON 驗證是資料品質的第一道門檻。格式正確不代表資料一定符合需求,但格式不正確時,後面的驗證根本無從開始。