字段标签和 JSON

结构体字段上的标签是元数据字符串，通过反射读取 通过 encoding/json、encoding/xml、验证器、ORM 等库。他们 写在字段类型后面的反引号（原始字符串）之间。

句法

type User struct {
    Name string `json:"nome"`
    Age  int    `json:"eta,omitempty"`
}

格式约定：key:"value" 以空格分隔（NOT 逗号）用于多个键：

type User struct {
    Email string `json:"email" validate:"required,email"`
}

json 标签：选项

最常见的选项是 json，由 encoding/json 使用：

type User struct {
    Name     string `json:"nome"`
    Age      int    `json:"eta,omitempty"`
    Password string `json:"-"`
}

u := User{Name: "Ada", Age: 0, Password: "segreto"}
b, _ := json.Marshal(u)
fmt.Println(string(b))   // {"nome":"Ada"}

Age 被省略（零值 0 + omitempty）； Password 是 完全排除。

元帅和元帅

// struct -> JSON
b, err := json.Marshal(u)

// JSON -> struct (needs a POINTER)
var u2 User
err = json.Unmarshal(b, &u2)

Unmarshal 只接受一个指针，因为它必须写入 值的字段。

其他常见标签

• xml:"..." — encoding/xml
• yaml:"..." — yaml.v3
• db:"..." — sqlx / pgx
• validate:"..." — go-playground/验证器
• form:"..." — gin / echo 绑定

库通过反射读取它们（reflect.StructTag.Get("json")）： 在有人解释它们之前它们只是字符串。

尝试一下

u := User{Name: "Ada", Age: 36}
b, _ := json.Marshal(u)
fmt.Println(string(b))

回顾

• 标签是反引号之间的原始字符串：`key:"value" key2:"value2"`.
• json:"nome": rename. omitempty: omit if zero value. -: exclude.
• NON-exported (lowercase) fields are ignored by encoding/json.
• json.Marshal(v) ↔ json.Unmarshal(数据, &v) (pointer).
• Same mechanism for xml, yaml, db, validate, form, …