结构体字段标签是 go 语言中附加在字段上的元数据字符串，本身不参与运行时逻辑，需通过反射（`reflect` 包）显式读取，常用于序列化（如 json、xml）、数据库映射、表单验证等场景。
在 Go 中，结构体字段标签（field tags）是写在结构体字段声明后、用反引号（`）包裹的字符串，语法为：json:"name,omitempty" db:"user_name" validate:"required"。它不是注释，也不是编译期或运行时自动生效的指令；而是一段纯字符串形式的结构化元信息，仅当代码主动通过反射获取时才被解析和使用。
例如：
type User struct {
Name string `json:"name" db:"username" validate:"required"`
Age int `json:"age" db:"user_age"`
Email string `json:"email" db:"email_address,omitempty"`
}上述 User 结构体中，每个字段后的反引号内内容即为标签。注意：标签必须是单个无换行的字符串字面量，且通常遵循 key:"value" 的键值对格式（多个键值可用空格分隔），这是 Go 社区约定，但语言本身不强制解析规则——具体如何解释由使用者决定。
要读取标签，必须借助 reflect 包。核心路径为：
reflect.TypeOf(instance).Elem().Field(i).Tag（对指针取 Elem() 获取底层结构体类型）→ 再调用 .Get("key") 或 .Lookup("key") 提取指定键的值：
func printJSONTag(v interface{}) {
t := reflect.TypeOf(v)
if t.Kind() == reflect.Ptr {
t = t.Elem()
}
if t.Kind() != reflect.Struct {
panic("expected struct or *struct")
}
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
jsonTag := field.Tag.Get("json") // 获取 json 标签值
fmt.Printf("Field %s → JSON tag: %q\n", field.Name, jsonTag)
}
}
// 使用示例
u := User{Name: "Alice", Age: 30}
printJSONTag(&u)
// 输出：
// Field Name → JSON tag: "name"
// Field Age → JSON tag: "age"
// Field Email → JSON tag: "email"⚠️ 注意事项：
- 标签不会自动影响任何行为：json.Marshal 能识别 json 标签，是因为 encoding/json 包内部使用了反射并按约定解析该标签；若自定义包未实现相应逻辑，则标签毫无作用。
- 标签字符串必须用反引号（而非双引号或单引号），否则编译报错。
- 空格敏感：json:"name,omitempty" 是合法的；json: "name"（冒号后有空格）会导致解析失败。
- Tag.Get(key) 在键不存在时返回空字符串；Tag.Lookup(key) 返回 (value, found bool)，更安全。
- 不建议在性能敏感路径频繁反射读取标签；可考虑启动时缓存解析结果（如 map[reflect.Type]map[string]string）。
总结而言，结构体标签是 Go 实现“声明式配置”的轻量机制——它将语义信息与数据结构耦合，交由上层库按需解释，从而在保持语言简洁性的同时，支撑了丰富的生态工具链（如 json、xml、gorm、validator 等）。正确理解其“静态元数据 + 反射驱动”的本质，是写出可维护、可扩展 Go 代码的关键之一。
