程式開發
JSON 是什麼?新手入門完整教學
從零開始了解 JSON 資料格式 — 語法規則、使用場景、常見錯誤,以及如何格式化和驗證 JSON。
什麼是 JSON?
JSON(JavaScript Object Notation,JavaScript 物件表示法)是一種輕量級的資料交換格式。雖然名字中有 JavaScript,但 JSON 是獨立於程式語言的,幾乎所有現代程式語言都支援 JSON。
JSON 由 Douglas Crockford 在 2001 年提出,因為其簡潔、易讀的特性,迅速成為網路上最流行的資料交換格式,取代了 XML 在許多場景中的地位。
一個簡單的 JSON 範例:
{
"name": "小明",
"age": 25,
"isStudent": false,
"hobbies": ["閱讀", "游泳", "程式設計"]
}
JSON 的基本語法
JSON 支援以下六種資料類型:
1. 字串(String):用雙引號包裹的文字
"Hello, World!"
2. 數字(Number):整數或浮點數,不需要引號
42, 3.14, -10
3. 布林值(Boolean):true 或 false
4. 空值(Null):null
5. 陣列(Array):用方括號包裹的有序值列表
[1, 2, 3] 或 ["a", "b", "c"]
6. 物件(Object):用大括號包裹的鍵值對集合
{"key": "value"}
重要規則:
• 鍵(key)必須是字串,且必須用雙引號(不能用單引號)
• 值可以是以上任何類型
• 物件和陣列可以巢狀
• 最後一個元素後面不能加逗號(trailing comma)
JSON 的常見使用場景
1. Web API 回應:大多數 RESTful API 使用 JSON 作為回應格式。當你的瀏覽器向伺服器請求資料時,伺服器通常會回傳 JSON。
2. 設定檔:許多應用程式使用 JSON 作為設定檔格式,例如 Node.js 的 package.json、VS Code 的 settings.json。
3. 資料儲存:NoSQL 資料庫(如 MongoDB)使用類 JSON 格式儲存資料。
4. 資料交換:前後端之間、微服務之間、不同系統之間的資料傳遞。
5. 國際化(i18n):許多網站使用 JSON 檔案管理多語言翻譯文字。
常見的 JSON 錯誤
初學者最常犯的 JSON 錯誤:
1. 使用單引號而非雙引號:
錯誤:{'name': 'test'}
正確:{"name": "test"}
2. 多餘的逗號:
錯誤:{"a": 1, "b": 2,}
正確:{"a": 1, "b": 2}
3. 未引用的鍵:
錯誤:{name: "test"}
正確:{"name": "test"}
4. 使用註解:
JSON 不支援註解。如果需要註解,考慮使用 JSON5 或 JSONC 格式。
5. 使用特殊值:
JSON 不支援 undefined、NaN、Infinity 等 JavaScript 特殊值。
如何使用 Gigi Tools 的 JSON 格式化工具
Gigi Tools 提供免費的線上 JSON 格式化和驗證工具:
• 貼上 JSON 文字,一鍵美化格式化
• 自動驗證 JSON 語法是否正確
• 如果有錯誤,會提示錯誤位置和原因
• 支援壓縮(minify)功能,減少資料傳輸大小
• 所有處理在瀏覽器中進行,您的資料不會被上傳
無論您是 API 開發者、前端工程師,還是正在學習程式設計的新手,這個工具都能幫您快速處理 JSON 資料。