以身作則，JSON元帥和Unmarshal

在Go 語言中，encoding/json 包用於處理JSON 的序列化和反序列化。 1. 結構體字段需首字母大寫才能被訪問，通過json:"name" 設置鍵名，omitempty 在值為零值時省略字段，json:"-" 忽略字段；2. 使用json.Marshal 將結構體、map 或切片轉換為JSON 字符串，使用json.Unmarshal 將JSON 數據解析到變量中；3. 反序列化到interface{} 時，數字默認為float64 類型，需通過類型斷言轉換；4. 嵌套結構體可正常序列化，內嵌結構體會被展開；5. 始終檢查Marshal 和Unmarshal 的錯誤，常見問題包括JSON 格式錯誤、類型不匹配和非導出字段。正確使用struct tag 和數據結構可靈活處理各類JSON 場景。

在Go 語言中， encoding/json包提供了對JSON 數據的序列化（marshal）和反序列化（unmarshal）支持。下面通過幾個常見的例子來演示如何使用json.Marshal和json.Unmarshal 。

✅ 基本結構體的Marshal 與Unmarshal

 package main

import (
    "encoding/json"
    "fmt"
    "log"
)

type Person struct {
    Name string `json:"name"`
    Age int `json:"age"`
    Email string `json:"email,omitempty"`
}

func main() {
    // 示例1: Marshal 結構體→ JSON
    p := Person{
        Name: "Alice",
        Age: 30,
        Email: "alice@example.com",
    }

    data, err := json.Marshal(p)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("Marshal result: %s\n", data)

    // 示例2: Unmarshal JSON → 結構體jsonData := `{"name":"Bob","age":25,"email":"bob@example.com"}`
    var p2 Person
    err = json.Unmarshal([]byte(jsonData), &p2)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("Unmarshal result: % v\n", p2)
}

輸出：

 Marshal result: {"name":"Alice","age":30,"email":"alice@example.com"}
Unmarshal result: {Name:Bob Age:25 Email:bob@example.com}

注意：

• json:"name"指定字段在JSON 中的鍵名。
• omitempty表示如果字段為零值（如空字符串、0、nil等），則序列化時省略。

✅ 處理map 的Marshal 和Unmarshal

 // Marshal map → JSON
m := map[string]interface{}{
    "name": "Charlie",
    "age": 35,
    "tags": []string{"go", "dev"},
}
data, _ := json.Marshal(m)
fmt.Printf("Map to JSON: %s\n", data)

// Unmarshal JSON → map
var m2 map[string]interface{}
jsonData := `{"name":"David","age":28,"active":true}`
json.Unmarshal([]byte(jsonData), &m2)
fmt.Printf("JSON to map: % v\n", m2)

// 注意：map 中的數字默認解析為float64
if age, ok := m2["age"].(float64); ok {
    fmt.Println("Age:", int(age))
}

輸出：

 Map to JSON: {"age":35,"name":"Charlie","tags":["go","dev"]}
JSON to map: map[age:28 name:David active:true]
Age: 28

⚠️ 注意： json.Unmarshal解析到interface{}時，數字默認是float64類型，需要類型斷言。

✅ 處理切片（Slice）和數組

people := []Person{
    {Name: "Alice", Age: 30},
    {Name: "Bob", Age: 25},
}

// Marshal slice
data, _ = json.Marshal(people)
fmt.Printf("Slice to JSON: %s\n", data)

// Unmarshal JSON array → slice
jsonData := `[{"name":"Eve","age":22},{"name":"Frank","age":33}]`
var people2 []Person
json.Unmarshal([]byte(jsonData), &people2)
fmt.Printf("JSON to slice: % v\n", people2)

輸出：

 Slice to JSON: [{"name":"Alice","age":30},{"name":"Bob","age":25}]
JSON to slice: [{Name:Eve Age:22 Email:} {Name:Frank Age:33 Email:}]

✅ 忽略空字段（omitempty 的使用）

 p := Person{
    Name: "Grace",
    Age: 0, // 零值// Email 留空}

data, _ = json.Marshal(p)
fmt.Printf("With omitempty: %s\n", data)

輸出：

 With omitempty: {"name":"Grace"}

因為Age是0（int 的零值），但沒有omitempty ，所以仍會輸出。
Email有omitempty且為空，所以被省略。

如果你想連零值也省略，可以這樣寫：

 Age int `json:"age,omitempty"`

✅ 嵌套結構體與自定義字段名

type Address struct {
    City string `json:"city"`
    Zip string `json:"zip"`
}

type User struct {
    Person `json:"person"` // 內嵌結構體Address Address `json:"address"`
    Password string `json:"-"` // 不參與序列化}

u := User{
    Person: Person{Name: "Helen", Age: 29},
    Address: Address{City: "Beijing", Zip: "100000"},
    Password: "secret123",
}

data, _ := json.Marshal(u)
fmt.Printf("Nested struct: %s\n", data)

輸出：

 Nested struct: {"person":{"name":"Helen","age":29},"address":{"city":"Beijing","zip":"100000"}}

• 內嵌結構體會被展開。
• json:"-"表示該字段不會被序列化或反序列化。

✅ 錯誤處理建議

使用json.Marshal和json.Unmarshal時，始終檢查錯誤：

 data, err := json.Marshal(someValue)
if err != nil {
    log.Printf("Marshal error: %v", err)
    return
}

err = json.Unmarshal(jsonData, &target)
if err != nil {
    log.Printf("Unmarshal error: %v", err)
    return
}

常見錯誤包括：

• JSON 格式不合法
• 類型不匹配（如期望數字但得到字符串）
• 字段不可導出（結構體字段必須大寫才能被json 包訪問）

小結：關鍵點

• 結構體字段必須首字母大寫才能被json包訪問。
• 使用json:"fieldName"自定義鍵名。
• omitempty可省略空值字段。
• json:"-"忽略字段。
• map[string]interface{}和[]interface{}可用於動態結構，但注意類型斷言。
• 數字在interface{}中默認是float64 。

基本上就這些。實際開發中，結合struct tag和合理的數據結構，就能靈活處理大多數JSON 場景。

以上是以身作則，JSON元帥和Unmarshal的詳細內容。更多資訊請關注PHP中文網其他相關文章！