在golang中可通过reflect包获取结构体字段及其标签信息。1. 使用reflect.typeof()获取结构体类型,通过numfield()和field(i)遍历字段;2. 利用field.tag.get("tagname")获取指定标签值,如json、gorm等;3. 对复杂标签如gorm:"column:name;type:varchar(100)"可自定义解析函数拆解键值对;4. 注意事项包括:标签不存在返回空字符串、字段必须导出、structtag不可修改、反射性能较低应避免高频使用。

在 Golang 中,反射(reflect)包为我们提供了运行时动态获取结构体字段及其标签信息的能力。如果你需要解析结构体中的 json、gorm 或自定义的 tag 标签,可以通过 Field.Tag 来实现。这在开发 ORM 框架、序列化工具或配置映射等场景中非常常见。

获取结构体字段的基本方法
要使用反射获取结构体字段的信息,首先需要通过 reflect.TypeOf() 获取结构体的类型对象。然后通过 .NumField() 和 .Field(i) 遍历每个字段。

举个例子:
立即学习“go语言免费学习笔记(深入)”;
type User struct {
Name string `json:"name" gorm:"column:name"`
Age int `json:"age"`
}
user := User{}
t := reflect.TypeOf(user)
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
fmt.Println("字段名:", field.Name)
}上面这段代码会输出结构体中每个字段的名字,比如 Name、Age。但我们的目标是获取这些字段上的标签内容,这就需要用到 field.Tag。

使用 field.Tag 获取和解析标签
每个结构体字段都有一个 Tag 字段,类型为 reflect.StructTag。你可以用类似 tag.Get("json") 的方式来获取特定的标签值。
继续上面的例子:
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
jsonTag := field.Tag.Get("json")
gormTag := field.Tag.Get("gorm")
fmt.Printf("字段 %s 的 json tag: %s\n", field.Name, jsonTag)
fmt.Printf("字段 %s 的 gorm tag: %s\n", field.Name, gormTag)
}这样就能分别获取 json 和 gorm 标签的内容。如果某个字段没有对应的标签,Get() 方法会返回空字符串。
注意:StructTag 实际上是一个字符串,它的格式是多个 key:"value" 的组合,比如 json:"name" gorm:"column:name"。Get() 方法内部就是解析这个字符串并提取对应 key 的 value。
解析更复杂的标签内容(如键值对)
有时候我们不仅需要获取整个标签值,还需要进一步解析其中的键值对。例如 gorm:"column:name;type:varchar(100)" 这样的标签,我们需要从中提取出 column 和 type 等信息。
虽然标准库没有直接提供解析这类结构的方法,但我们可以通过字符串操作手动处理:
func parseGormTag(tag string) map[string]string {
result := make(map[string]string)
pairs := strings.Split(tag, ";")
for _, pair := range pairs {
kv := strings.Split(pair, ":")
if len(kv) == 2 {
result[strings.TrimSpace(kv[0])] = strings.TrimSpace(kv[1])
}
}
return result
}使用示例:
gormTag := field.Tag.Get("gorm")
parts := parseGormTag(gormTag)
fmt.Println("column:", parts["column"])
fmt.Println("type:", parts["type"])这种方式适用于大多数简单的结构体标签解析需求。
常见问题与注意事项
-
标签不存在时返回空字符串:调用
Tag.Get("xxx")时如果标签不存在,会返回空字符串,记得做空判断。 -
字段必须导出(首字母大写)才能被反射访问:否则
reflect无法读取其信息。 -
不要修改 Tag 内容:
StructTag是只读的,不能进行赋值或修改。 - 性能考虑:反射操作相对比较慢,尽量避免在高频函数中频繁使用。
基本上就这些。掌握 reflect.StructField.Tag 的使用后,你就可以轻松读取结构体字段上的各种元信息了。不复杂,但很容易忽略细节,特别是标签格式和解析方式的选择。










