Go 如何处理 JSON 序列化和反序列化？

Question

仓乃文 · Accepted Answer

Go 使用 encoding/json 标准库处理 JSON，通过结构体 tag 控制字段映射，支持自定义序列化逻辑。

基础序列化与反序列化：
```go
package main

import (
    "encoding/json"
    "fmt"
)

type User struct {
    ID    int    `json:"id"`              // tag 指定 JSON 字段名
    Name  string `json:"name"`
    Email string `json:"email,omitempty"` // omitempty: 空值时不输出
    Age   int    `json:"-"`               // "-" 表示忽略该字段
}

func main() {
    // 序列化（结构体 → JSON）
    user := User{ID: 1, Name: "张三", Email: ""}
    data, _ := json.Marshal(user)
    fmt.Println(string(data))  // {"id":1,"name":"张三"}（Email 为空被 omitempty 忽略）

// 反序列化（JSON → 结构体）
    jsonStr := `{"id":2,"name":"李四","email":"li@test.com"}`
    var u User
    json.Unmarshal([]byte(jsonStr), &u)  // 必须传指针
    fmt.Printf("%+v
", u)  // {ID:2 Name:李四 Email:li@test.com Age:0}
}
```

处理动态 JSON（未知结构）：
```go
// 解析为 map[string]interface{}
var result map[string]interface{}
json.Unmarshal([]byte(jsonStr), &result)
fmt.Println(result["name"])  // 访问字段

// 使用 json.RawMessage 延迟解析
raw := struct {
    Type string          `json:"type"`
    Data json.RawMessage `json:"data"`  // 保留原始 JSON
}{}
json.Unmarshal([]byte(jsonStr), &raw)
```

补充说明：
- tag 格式：`json:"字段名,选项"`，选项有 omitempty、string 等
- 结构体字段必须首字母大写（导出）才能被 json 包访问
- json.RawMessage 可以延迟解析，根据 type 字段分发到不同结构体
- 自定义序列化实现 json.Marshaler 和 json.Unmarshaler 接口