Golang反射获取结构体字段与标签技巧-Golang-PHP中文网

Golang反射获取结构体字段与标签技巧

P粉602998670

发布： 2025-09-25 18:58:01

原创

415人浏览过

答案：Go反射可动态获取结构体字段名、类型、标签及值，并支持修改字段。通过reflect.TypeOf和reflect.ValueOf获取类型与值信息，遍历字段读取json等标签，修改时需传指针并调用Elem()解引用，仅导出字段可被设置，常用于序列化、ORM等场景。

golang反射获取结构体字段与标签技巧

在Go语言中，反射（reflect）是处理未知类型数据的强大工具，尤其在处理结构体字段和标签时非常实用。通过反射，我们可以在运行时动态获取结构体的字段名、字段值以及结构体标签（如json、db等），这在序列化、ORM框架、参数校验等场景中广泛使用。

获取结构体字段基本信息

要通过反射获取结构体字段，首先需要将结构体实例传入reflect.ValueOf()和reflect.TypeOf()。其中TypeOf用于获取类型信息，ValueOf用于获取值信息。

以下是一个简单示例：

// 定义一个结构体
type User struct {
  Name string `json:"name"`
  Age int    `json:"age"`
}

func main() {
  u := User{Name: "Alice", Age: 30}
  t := reflect.TypeOf(u)

  // 遍历结构体字段
  for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    fmt.Printf("字段名: %s, 类型: %s\n", field.Name, field.Type)
  }
}

输出结果：

立即学习“go语言免费学习笔记（深入）”；

字段名: Name, 类型: string
字段名: Age, 类型: int

读取结构体标签（Struct Tag）

结构体标签常用于定义字段的元信息，比如JSON序列化名称、数据库列名等。通过field.Tag.Get("key")可以提取指定标签的值。

继续上面的例子：

AI Sofiya

一款AI驱动的多功能工具

109

查看详情

for i := 0; i < t.NumField(); i++ {
  field := t.Field(i)
  jsonTag := field.Tag.Get("json")
  fmt.Printf("字段 %s 的 json 标签是: %s\n", field.Name, jsonTag)
}

输出：

字段 Name 的 json 标签是: name
字段 Age 的 json 标签是: age

如果标签不存在，Get方法返回空字符串。你也可以使用lookup语法判断标签是否存在：

if jsonTag, ok := field.Tag.Lookup("json"); ok {
fmt.Println("json标签存在:", jsonTag)
} else {
fmt.Println("json标签不存在")
}

修改结构体字段值（需传指针）

反射不仅能读取字段，还能修改字段值，但必须传入结构体指针，否则会引发panic。

func setField() {
  u := &User{Name: "Bob", Age: 25}
  v := reflect.ValueOf(u).Elem() // 获取指针指向的元素

  // 修改 Name 字段
  if field := v.FieldByName("Name"); field.CanSet() {
    field.SetString("Charlie")
  }

  fmt.Printf("修改后: %+v\n", *u) // 输出: 修改后: {Name:Charlie Age:25}
}

注意：只有导出字段（首字母大写）才能被反射修改，且必须确保CanSet()为true。