首页 > Golang > Go教程

Golang反射获取结构体字段方法

时间：2025-10-18 08:26:28 278浏览收藏

今日不肯埋头，明日何以抬头！每日一句努力自己的话哈哈~哈喽，今天我将给大家带来一篇《Golang反射获取结构体字段技巧》，主要内容是讲解等等，感兴趣的朋友可以收藏或者有更好的建议在评论提出，我都会认真看的！大家一起进步，一起学习！

答案：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)
  }
}

输出结果：

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

读取结构体标签（Struct Tag）

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

继续上面的例子：

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。

实用技巧与注意事项

结构体标签使用反引号包裹，格式为key:"value"，多个标签用空格分隔
使用reflect.TypeOf获取类型信息，reflect.ValueOf获取值信息
修改字段时必须传指针，并调用.Elem()解引用
嵌套结构体可递归遍历，结合Kind()判断是否为结构体类型
匿名字段（嵌入字段）也会被遍历到，可通过field.Anonymous判断

基本上就这些。掌握这些技巧后，就能灵活地在配置解析、数据映射、校验等场景中使用反射处理结构体字段与标签了。不复杂但容易忽略细节，比如指针传递和字段可设置性检查。

本篇关于《Golang反射获取结构体字段方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！