Golang反射如何遍历结构体的字段_Golang通过反射遍历结构体的字段与标签

5次阅读

必须传指针才能读取结构体字段值,否则仅得只读副本;未导出字段不可读;需用 reflect.ValueOf(&u).Elem() 获取可读值;字段名、标签、值须分别通过 Type 和 Value 获取;嵌套类型需递归处理,并注意空指针循环引用。

Golang反射如何遍历结构体的字段_Golang通过反射遍历结构体的字段与标签

必须传指针,否则字段值读不到

直接传结构体变量(如 reflect.ValueOf(u))得到的是只读副本,.Field(i) 能取到字段名和类型,但调用 .Interface().String() 会 panic 或返回零值。真正想读值,得传指针:reflect.ValueOf(&u).Elem() —— 这一步不能省。

  • 未导出字段(小写开头)永远无法读取值,.CanInterface() 返回 false,强行调用会 panic
  • 传指针还能避免大结构体拷贝,性能更稳
  • 如果函数签名是 func print(v interface{}),内部第一件事就是检查是否为指针并 .Elem()

字段名和标签要分开拿:Type 和 Value 各司其职

reflect.typeof() 给你字段元信息:名字、类型、标签;reflect.ValueOf() 给你运行时的值。两者必须配合,不能混用。

  • 字段名、json 标签、validate 规则 → 全部从 t.Field(i).Namet.Field(i).Tag.Get("json")
  • 字段当前值 → 必须用 v.Field(i).Interface(),且 vreflect.Value 类型(已 .Elem() 过)
  • 想跳过被 json:"-" 屏蔽的字段?先取 tag := field.Tag.Get("json"),再判断 tag == "-"

嵌套结构体、切片map 得递归,否则只看到第一层

反射不会自动展开嵌套。一个 User 字段里有 Address *Address,不递归就只打印出 *main.Address 类型,看不到里面字段。

  • 对每个字段值做 rv.kind() 判断:是 reflect.Struct 就递归;是 reflect.Ptr.Elem() 再判;是 reflect.Slicereflect.Map 就遍历元素/value 并递归
  • 空指针必须提前检查:if rv.Kind() == reflect.Ptr && rv.IsNil() { ... },否则 .Elem() panic
  • 递归时传入缩进字符串(如 indent + " "),能立刻看出嵌套层级,调试友好

标签里的选项(比如 omitempty)得手动拆,Get 不会解析

field.Tag.Get("json") 返回的是完整字符串,如 "id,omitempty",不是结构化数据。想判断是否含 omitempty,得自己切分。

立即学习go语言免费学习笔记(深入)”;

  • strings.Split(tag, ","),首项是字段名("id"),后续是选项数组(["omitempty"]
  • 别依赖 strings.Contains(tag, "omitempty") —— 如果字段名本身含 omitempty(极少见但可能),会误判
  • 如果需要兼容多种 tag(jsondbyaml),建议封装一个 getTagKey(field, "json", "name") 工具函数,优先取 tag 中指定 key 的主键部分

容易被忽略的一点:反射无法检测循环引用。一个结构体字段指向自身或间接闭环(A→B→A),递归下去会溢出。真实项目中若需深度打印,得加访问路径记录或深度限制。

text=ZqhQzanResources