Go语言json包通过结构体标签、指针与零值处理、错误处理及RawMessage实现高效JSON解析与序列化。支持字段映射、omitempty忽略零值、嵌套结构、动态解析等核心功能。
Go 语言内置的 encoding/json 包提供了简洁、高效、安全的 JSON 解析与序列化能力，无需第三方依赖。核心在于理解结构体标签（struct tags）、指针与零值行为、以及错误处理习惯。
定义结构体并映射 JSON 字段
用结构体表示 JSON 数据结构是最常见方式。通过 json: 标签控制字段名映射、是否忽略、是否必须存在等行为：
-
字段名映射：默认按首字母大写的导出字段名匹配，可用
json:"name"显式指定； -
忽略字段：用
json:"-"完全跳过，或json:",omitempty"在值为零值时省略输出； - 嵌套与数组：结构体字段可为其他结构体或切片，自动递归处理。
示例：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"` // 空字符串时不输出
Tags []string `json:"tags"`
Meta map[string]interface{} `json:"meta"`
}
将 JSON 字符串解析为 Go 值（Unmarshal）
使用 json.Unmarshal([]byte, &v) 将字节流反序列化到变量。注意传入地址（&v），且目标必须是可寻址的变量。
立即学习“go语言免费学习笔记（深入）”；
- 如果 JSON 字段在结构体中不存在，会被静默忽略；
- 类型不匹配会返回错误（如 JSON 数字写入 string 字段）；
- 支持部分解析：结构体只定义需要的字段，其余自动丢弃。
示例：
<pre>data := `{"id":123,"name":"Alice","tags":["dev","go"]}`var u User
err := json.Unmarshal([]byte(data), &u)
if err != nil {
log.Fatal(err)
}
// u.ID == 123, u.Name == "Alice", u.Tags == []string{"dev","go"}</pre>
将 Go 值序列化为 JSON 字符串（Marshal）
用 json.Marshal(v) 把 Go 变量转成 JSON 字节切片。输出无空格、紧凑格式；若需缩进美化，用 json.MarshalIndent(v, "", " ")。
- 导出字段（首字母大写）才会被序列化；
-
omitempty标签对零值（0、""、nil、false 等）生效； - 时间、自定义类型需实现
MarshalJSON()方法才能正确转换。
示例：
<pre>u := User{ID: 456, Name: "Bob", Tags: []string{"test"}}b, _ := json.Marshal(u)
// b == {"id":456,"name":"Bob","tags":["test"]}</pre>
处理未知或动态 JSON（map[string]interface{} 和 json.RawMessage）
当 JSON 结构不确定或部分嵌套内容需延迟解析时，可用通用类型：
-
map[string]interface{}：适合快速读取任意对象，但需手动类型断言； -
json.RawMessage：延迟解析某字段，避免重复解码，特别适合嵌套 JSON 字符串； - 结合
interface{}+ 类型判断可实现灵活路由逻辑（如不同消息类型共用一个字段）。
示例（延迟解析）：
<pre>type Event struct {Type string `json:"type"`
Data json.RawMessage `json:"data"`
}
var e Event
json.Unmarshal(b, &e)
if e.Type == "user_created" {
var u User
json.Unmarshal(e.Data, &u)
// 处理用户数据
}</pre>
基本上就这些。熟练掌握结构体标签、零值处理和 RawMessage 的组合，就能应对绝大多数 JSON 场景。
