

新闻资讯
技术学院结构体字段标签是附加在字段上的元数据字符串,用于为序列化、验
证、数据库映射等提供配置信息;它们本身不参与运行时逻辑,需通过反射(`reflect` 包)读取和解析,常见于 `json`、`xml`、`gorm` 等标准库与第三方库中。
在 Go 中,结构体字段标签(struct tags)是以反引号包裹的字符串,紧跟在字段类型之后,语法形式为:`key:"value" key2:"value2"`。例如:
type User struct {
Name string `json:"name" xml:"name" validate:"required"`
Email string `json:"email" xml:"email" validate:"email"`
Age int `json:"age,omitempty" xml:"age"`
}这里的 json:"name"、xml:"name" 和 validate:"required" 都是字段标签,每个标签由一个键(key) 和一个带引号的值(value) 组成,多个键值对以空格分隔。注意:标签内容不会被编译器检查或执行——它纯粹是供运行时反射读取的字符串。
要访问字段标签,必须使用 reflect 包。以下是一个完整示例,演示如何获取并解析 json 标签:
package main
import (
"fmt"
"reflect"
)
type User struct {
Name string `json:"name" db:"user_name"`
Email string `json:"email"`
}
func main() {
u := User{}
t := reflect.TypeOf(u)
// 遍历结构体所有字段
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
fmt.Printf("字段名: %s\n", field.Name)
// 获取 json 标签值
jsonTag := field.Tag.Get("json")
fmt.Printf(" json 标签: %q\n", jsonTag) // 输出: "name", "email"
// 获取自定义 db 标签
dbTag := field.Tag.Get("db")
fmt.Printf(" db 标签: %q\n", dbTag) // 输出: "user_name", ""
}
}⚠️ 重要注意事项:
总结来说,结构体标签是 Go 实现“约定优于配置”的关键机制之一:它让结构体既能保持简洁干净,又能灵活支持多种序列化、校验、持久化场景。掌握 reflect.StructTag 的使用,是编写可扩展 Go 库和框架的基础能力。