CodeGym /課程 /C# SELF /基礎 JSON 格式與其流行原因

基礎 JSON 格式與其流行原因

C# SELF
等級 43, 課堂 4
開放

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 範例
string
"name": "伊凡"
int, double
"score": 5
bool
"isStudent": true
陣列 (int[], ...)
"scores": [5,4,5,3]
物件 (class, ...)
"contacts": { ... }
null
"phone": null

JSON 的記法規則

  1. 字串一定要用雙引號:'text' — 錯誤,正確是 "text"。
  2. 物件的鍵必須是雙引號的字串,例如 "name": ...
  3. 逗號只出現在元素之間,最後一個元素後面不得有尾逗號。
  4. 縮排不是必須的,但能提高可讀性。
  5. 數字不應該有引號:"age": 25,而不是 "age": "25"。
  6. 布林值要用 true/false(沒有引號),不是 True、FALSE 或 "true"。
  7. 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 函式庫:

最小的序列化/反序列化範例:

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,應用可能會明顯掉效能。

2
任務
C# SELF, 等級 43, 課堂 4
上鎖
從二進位檔案讀取資料
從二進位檔案讀取資料
1
問卷/小測驗
認識序列化,等級 43,課堂 4
未開放
認識序列化
資料序列化的概念
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION