struct tag用于为结构体字段添加元信息，通过反射可在运行时解析这些标签以控制序列化、数据库映射等行为。1. 标签写在反引号内，格式为key:"value"，如json:"name"；2. 使用reflect.TypeOf获取类型信息，遍历字段并调用Field.Tag.Get("key")读取标签值；3. 常见应用包括JSON序列化、GORM数据库映射和参数校验；4. 注意标签必须是字面字符串、字段需导出、多个标签用空格分隔。示例中User结构体的Name字段对应json键名"name"且必填，Email字段在为空时忽略输出。该机制是Go实现元编程的重要方式。
在Go语言中，struct tag 是一种为结构体字段附加元信息的机制，常用于控制序列化（如 JSON、XML）、数据库映射（如 GORM）、参数校验等行为。结合 反射（reflect），程序可以在运行时读取这些标签并做出相应处理。下面详细介绍 struct tag 的语法和如何通过反射解析它们。
struct tag 语法
struct tag 写在结构体字段后面的反引号（``）中，格式为：
`key1:"value1" key2:"value2"`
每个键值对表示一个标签，key 通常是库定义的标识符（如 json、xml、gorm），value 提供具体配置。
示例：
type User struct {
Name string `json:"name" validate:"required"`
Age int `json:"age" validate:"min=0"`
Email string `json:"email,omitempty"`
}
说明：
-
json:"name"：该字段在转为 JSON 时使用 "name" 作为键名
-
omitempty：如果字段为空值（如 ""、0、nil），序列化时忽略该字段
-
validate:"required"：用于校验规则，表示该字段必填
通过反射解析 struct tag
要读取 struct tag，需要使用 reflect 包。核心步骤是：
- 获取结构体类型的 reflect.Type
- 遍历每个字段（Field）
- 调用 Field.Tag.Get("key") 获取指定标签值
示例代码：
package main
import (
"fmt"
"reflect"
)
type User struct {
Name string `json:"name" validate:"required"`
Age int `json:"age" validate:"min=0"`
Email string `json:"email,omitempty"`
}
func main() {
u := User{}
t := reflect.TypeOf(u)
for i := 0; i field := t.Field(i)
jsonTag := field.Tag.Get("json")
validateTag := field.Tag.Get("validate")
fmt.Printf("字段: %s, json tag: %s, validate tag: %s\n",
field.Name, jsonTag, validateTag)
}
}
输出：
字段: Name, json tag: name, validate tag: required
字段: Age, json tag: age, validate tag: min=0
字段: Email, json tag: email,omitempty, validate tag:
注意：
- Tag 是字符串类型，需用 Get 方法提取指定 key 的值
- 像
json:"email,omitempty" 这样的复合值，Get 返回完整字符串，可进一步用 strings.Split 解析
- 如果标签不存在，Get 返回空字符串
实际应用场景
struct tag 常见用途包括：
-
JSON 序列化：控制字段名、是否忽略空值
-
数据库映射：GORM 使用 tag 指定表名、列名、约束等
-
参数校验：如使用
validator 库进行输入验证
-
配置解析：从 YAML/JSON 配置文件映射到结构体
例如 GORM tag：
type Product struct {
ID uint `gorm:"primaryKey"`
Name string `gorm:"size:100;not null"`
Code string `gorm:"uniqueIndex"`
}
注意事项
- tag 必须是**字面字符串**，不能是变量
- 反引号内不能换行
- 多个 tag 之间用空格分隔，不要用逗号
- 字段必须是导出的（大写字母开头），否则反射无法访问
基本上就这些。struct tag + 反射是 Go 实现灵活元编程的重要手段，掌握它有助于理解很多框架的工作原理。不复杂
但容易忽略细节。
但容易忽略细节。