JSON（JavaScript Object Notation）是一种常见的数据交换格式。Go 标准库提供了
encoding/json包，用于方便地将结构体与 JSON 之间互转。
一、序列化（Marshal）
将 Go 中的数据结构（如结构体、map、slice 等）转换为 JSON 字符串，称为“序列化”。
1. 基本示例：
package main
import (
"encoding/json"
"fmt"
)
type Person struct {
Name string
Age int
}
func main() {
p := Person{Name: "Tom", Age: 30}
data, _ := json.Marshal(p)
fmt.Println(string(data)) // 输出：{"Name":"Tom","Age":30}
}
二、反序列化（Unmarshal）
将 JSON 字符串转换为 Go 数据结构的过程，称为“反序列化”。
示例：
jsonStr := `{"Name":"Alice","Age":25}`
var p Person
json.Unmarshal([]byte(jsonStr), &p)
fmt.Println(p.Name, p.Age) // 输出：Alice 25
三、结构体字段标签（Tag）
Go 的 json 标签用于控制字段与 JSON 键之间的映射。
type Person struct {
Name string `json:"name"` // 指定键为 name
Age int `json:"age"`
}
输出示例：
p := Person{Name: "Tom", Age: 20}
data, _ := json.Marshal(p)
fmt.Println(string(data)) // {"name":"Tom","age":20}
四、控制字段行为的标签
| 标签形式 | 含义 |
|---|---|
json:"name" | 重命名字段为 name |
json:"name,omitempty" | 若字段值为空则忽略 |
json:"-" | 忽略该字段，不进行序列化/反序列化 |
示例：
type User struct {
Name string `json:"name"`
Token string `json:"-"` // 忽略
Age int `json:"age,omitempty"` // 0 则不输出
}
五、处理 map 和切片
data := map[string]interface{}{
"name": "Go",
"year": 2009,
}
bytes, _ := json.Marshal(data)
fmt.Println(string(bytes)) // {"name":"Go","year":2009}
六、嵌套结构体序列化
type Address struct {
City string `json:"city"`
State string `json:"state"`
}
type User struct {
Name string `json:"name"`
Address Address `json:"address"`
}
序列化会生成嵌套的 JSON 结构：
{
"name": "Bob",
"address": {
"city": "Beijing",
"state": "CN"
}
}
七、反序列化未知结构（使用 map[string]interface{}）
str := `{"name":"Go","version":1.18}`
var result map[string]interface{}
json.Unmarshal([]byte(str), &result)
fmt.Println(result["name"]) // Go
fmt.Println(result["version"].(float64)) // 1.18
注意：数字默认会被解析为 float64。
八、处理 JSON 数组
jsonStr := `[{"name":"Tom"},{"name":"Jerry"}]`
var users []map[string]string
json.Unmarshal([]byte(jsonStr), &users)
fmt.Println(users[0]["name"]) // Tom
九、小结
| 功能 | 方法名 | 类型要求 |
|---|---|---|
| 序列化 | json.Marshal() | 输入：结构体/map/slice |
| 反序列化 | json.Unmarshal() | 输出：指针（结构体/map） |
