1. 介紹
如果你曾經打開過現代的 API、使用過 web 服務、行動應用,或甚至只是想把東西存成「通用格式」——你已經接觸過或會遇到 JSON。這是讓不同程式語言與平台互通的那種格式:C#、JavaScript、Python —— 都用 JSON 來溝通。
為什麼 JSON 會成為序列化的明星?答案很簡單:它是緊湊、可讀且輕量的結構化資料文字格式。它的流行來自於簡單性、通用性以及各程式語言的優秀支援。
什麼是 JSON?
JSON 是 JavaScript Object Notation 的縮寫。這個格式起源於 JavaScript,但很快就跳出瀏覽器走向更大的世界。重要的是:儘管名字來自 JavaScript,JSON 並不綁定於 JavaScript,對所有程式語言都很方便。
這個格式在 2000 年代初由 Douglas Crockford 發明,作為比冗長的 XML 更簡單的替代品。想法很直接:「JSON 更短、更簡單,眼睛更容易閱讀」。
2. JSON 格式的基本規則
最主要的是:JSON 是一個嚴格定義的 文字 格式,用於結構化資料。沒有魔法,只有普通文字,任何編輯器都能打開。
基本構造:
- 陣列 (arrays):有順序的值清單。
- 物件 (objects):鍵-值對的集合。
- 簡單型別:字串、數字、布林值 (true, false) 和特殊值 null。
最小的 JSON 文件示例:
{
"name": "伊凡",
"age": 25,
"isStudent": true,
"scores": [5, 4, 5, 3],
"contacts": {
"email": "ivan@example.com",
"phone": null
}
}
示意結構
下面是 C# 類型與 JSON 表示的簡單對照表:
| C# 型別 | JSON 範例 |
|---|---|
|
|
|
|
|
|
| 陣列 (int[], ...) | |
| 物件 (class, ...) | |
|
|
JSON 的記法規則
- 字串一定要用雙引號:'text' — 錯誤,正確是 "text"。
- 物件的鍵必須是雙引號的字串,例如 "name": ...
- 逗號只出現在元素之間,最後一個元素後面不得有尾逗號。
- 縮排不是必須的,但能提高可讀性。
- 數字不應該有引號:"age": 25,而不是 "age": "25"。
- 布林值要用 true/false(沒有引號),不是 True、FALSE 或 "true"。
- null 要寫成 null(沒有引號)。
3. 程式設計師眼中的 JSON
跟 C# 型別的類比:
- JSON 物件 ≈ Dictionary<string, object>
- JSON 陣列 ≈ T[] 或 List<T>
- JSON 字串 ≈ 一般的字串
- JSON 數字 ≈ int 或 double(視數值而定)
把物件序列化成 JSON 的範例
類別定義:
public class Student
{
public string Name { get; set; } = "";
public int Age { get; set; }
public bool IsStudent { get; set; }
public int[] Scores { get; set; } = Array.Empty<int>();
}
得到的 JSON(簡化處理細節):
{
"Name": "伊凡",
"Age": 25,
"IsStudent": true,
"Scores": [5, 4, 5, 3]
}
4. 合法的 JSON 結構範例
含陣列與巢狀物件的物件
{
"product": "咖啡",
"price": 125.50,
"inStock": true,
"attributes": {
"weight": 500,
"unit": "公克"
},
"tags": ["飲料", "能量", "阿拉比卡"],
"promotions": null
}
物件陣列
[
{"id": 1, "name": "彼得"},
{"id": 2, "name": "瑪莎"},
{"id": 3, "name": "瓦西里"}
]
5. 不合法的 JSON 範例(以及為什麼)
單引號:
{ 'name': '伊凡' } // 錯誤!
JSON 要求使用雙引號。
最後一個元素後的逗號:
{ "x": 1, "y": 2, } // 錯誤!
最後多餘的逗號是不允許的。
註解:
{
// 這種漂亮的註解可惜在 JSON 裡不行
"name": "伊凡"
}
JSON 沒有註解。
6. 為什麼在真實專案中需要 JSON?
系統之間的資料傳遞
JSON 是不同程式之間的通用「共同語言」,通常搭配 HTTP 使用。例如,一個後端用 C# 的伺服器和前端用 JavaScript 的介面溝通時,大家的共同格式就是 JSON。
設定與資料儲存
很多應用把設定存成 .json 檔案。像是 appsettings.json —— 這是 .NET 應用的慣例。優點:容易閱讀、修改與版本控制。
伺服器與行動 API
大多數 REST API 使用 JSON 作為請求與回應格式:例如,使用者清單會以物件陣列的形式傳回。
工具與函式庫的設定
許多 .NET 工具(像 Serilog、Swagger 等)用 JSON 做設定。XML 越來越少見 —— JSON 更精簡也更直觀。
7. JSON 的受歡迎原因
- 可讀性。 即使不是程式設計師也能大致看懂結構。
- 傳輸便利。 純文字,體積小。
- 各語言支援良好。 序列化/反序列化幾乎「開箱即用」。
- 適合設定檔。 各種編輯器都能很好地編輯它。
- 生成簡單。 構造 JSON 很直觀。
- 陣列、巢狀、null。 結構直觀,不像 XML 那樣「括號泛濫」。
什麼時候應該選 JSON?
- 你在做行動或網頁應用;
- 你在和外部服務的 API 互動;
- 你希望你的應用容易與未來整合。
8. C# 如何處理 JSON
簡短介紹常見的 .NET 函式庫:
- System.Text.Json — 標準、快速且簡單。
- Newtonsoft.Json (Json.NET) — 功能強大的老牌函式庫。
最小的序列化/反序列化範例:
using System.Text.Json;
// 把物件轉成 JSON 字串
var student = new Student { Name = "伊凡", Age = 25, IsStudent = true, Scores = new[] {5, 4, 5, 3} };
string json = JsonSerializer.Serialize(student);
// 反過來:從 JSON 字串讀回物件
Student? parsed = JsonSerializer.Deserialize<Student>(json);
Console.WriteLine(json);
9. 新手處理 JSON 常見錯誤
常見錯誤 — 搞錯引號或忘記逗號。有時候會想加註解(像在 C# 那樣——這很方便!),但 JSON 不允許註解。
另一個常見情況是序列化時沒有初始化集合:結果會得到 "scores": null 而不是預期的陣列。記得事先初始化集合。
別忘了 JSON 是文字:大量資料會佔很多記憶體。如果把大約 500 MB 的資料序列化成 JSON,應用可能會明顯掉效能。
GO TO FULL VERSION