Golang encoding/json用法 结构体标签解析

结构体标签控制Go中JSON序列化与反序列化行为。1. json:"name"指定字段名映射；2. omitempty在零值时跳过字段；3. -忽略字段；4. string以字符串形式编码数字或布尔值；5. 嵌套与指针字段自动处理，nil指针不输出；6. 反序列化优先匹配标签名，其次字段名（不区分大小写），多余字段忽略。仅导出字段（首字母大写）生效。

在 Go 语言中，encoding/json 包用于处理 JSON 数据的序列化和反序列化。结构体标签（struct tags）是控制字段如何被编码或解码的关键。下面详细介绍其常见用法和标签解析规则。

基本序列化与反序列化

使用 json.Marshal 将 Go 结构体转换为 JSON 字符串，使用 json.Unmarshal 将 JSON 数据解析回结构体。

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

user := User{Name: "Alice", Age: 30}
data, _ := json.Marshal(user)
fmt.Println(string(data)) // {"name":"Alice","age":30}

var u User
json.Unmarshal(data, &u)

结构体标签语法：json:"key,options"

结构体字段后的 ``json:"..."`` 是标签，用于定义该字段在 JSON 中的名称和行为。

常见格式：

json:"字段名[,选项]"

常用选项包括：

立即学习“go语言免费学习笔记（深入）”；

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

30

查看详情

• string：将数字或布尔值以字符串形式编码（常用于兼容某些 API）
• omitempty：当字段为零值时，不输出到 JSON 中
• -：忽略该字段，不参与序列化或反序列化

type Product struct {
    ID     int     `json:"id"`
    Name   string  `json:"product_name"`
    Price  float64 `json:"price,omitempty"`
    Secret string  `json:"-"`
    Count  int     `json:"count,string"`
}

• ID 映射为 "id"
• Name 输出为 "product_name"
• Price 若为 0，则不会出现在 JSON 中
• Secret 字段完全忽略
• Count 会以字符串形式编码，如 "10"

嵌套结构与指针字段处理

结构体嵌套时，标签同样适用。指针字段在序列化时会自动解引用。

type Address struct {
    City  string `json:"city"`
    Zip   string `json:"zip_code,omitempty"`
}

type Person struct {
    Name    string   `json:"name"`
    Address *Address `json:"address,omitempty"`
}

• 如果 Address 为 nil，输出 JSON 中不包含 address 字段
• 若 Address 有值，自动展开其字段

反序列化时的字段匹配规则

json.Unmarshal 会根据标签或字段名匹配 JSON 键。

• 优先使用

  json:"xxx"

  登录后复制
  标签中的名称
• 若无标签，使用字段名（需首字母大写，即导出字段）
• 匹配不区分大小写，但精确匹配优先
• JSON 中多余字段默认被忽略

只有导出字段（字段名首字母大写）才会被 encoding/json 处理。

基本上就这些。结构体标签是 Go 处理 JSON 的核心机制，掌握标签用法能灵活应对各种数据格式需求。

以上就是Golang encoding/json用法 结构体标签解析的详细内容，更多请关注php中文网其它相关文章！