在Golang的实际开发中，反射是处理动态类型、动态获取类型信息的重要机制，当我们需要遍历结构体的所有字段并获取对应的值时，reflect包就能发挥核心作用。通过反射可以在运行时获取结构体的字段数量、字段名称、字段类型以及字段对应的实际值，满足很多通用场景的开发需求。
反射遍历结构体的核心原理
要使用reflect遍历结构体字段，首先需要理解reflect包的两个核心类型：reflect.Type和reflect.Value。reflect.Type用于获取类型的相关信息，比如结构体的字段列表、字段的类型等；reflect.Value用于获取值的实际内容，也就是字段对应的具体值。遍历结构体的基本流程是先通过reflect.TypeOf获取结构体的类型信息，再通过reflect.ValueOf获取结构体的值信息，最后循环遍历类型信息中的字段列表，逐个获取对应的值。
基础遍历示例：获取字段名和字段值
下面是一个简单的示例，定义一个普通的结构体，然后通过反射遍历它的所有字段，打印出字段名和对应的字段值：
package main
import (
"fmt"
"reflect"
)
// 定义测试结构体
type UserInfo struct {
Name string
Age int
Score float64
}
func main() {
// 创建结构体实例
user := UserInfo{
Name: "张三",
Age: 25,
Score: 92.5,
}
// 获取结构体的反射类型
t := reflect.TypeOf(user)
// 获取结构体的反射值
v := reflect.ValueOf(user)
// 遍历所有字段
for i := 0; i < t.NumField(); i++ {
// 获取第i个字段的类型信息
field := t.Field(i)
// 获取第i个字段的值
fieldValue := v.Field(i)
// 打印字段名、字段类型、字段值
fmt.Printf("字段名：%s, 字段类型：%v, 字段值：%vn", field.Name, field.Type, fieldValue.Interface())
}
}
运行上述代码，输出结果如下：
字段名：Name, 字段类型：string, 字段值：张三 字段名：Age, 字段类型：int, 字段值：25 字段名：Score, 字段类型：float64, 字段值：92.5
处理指针类型的结构体
在实际开发中，我们经常会遇到结构体指针的场景，比如函数接收的是结构体指针参数。如果直接对指针类型的变量使用reflect.TypeOf和reflect.ValueOf，获取到的是指针的类型和值，无法直接遍历结构体的字段，这时候需要先通过Elem()方法获取指针指向的实际元素类型和值：
package main
import (
"fmt"
"reflect"
)
type Product struct {
ID int
Name string
Price float64
}
func traverseStruct(ptr interface{}) {
// 获取反射值
v := reflect.ValueOf(ptr)
// 判断是否为指针类型
if v.Kind() != reflect.Ptr {
fmt.Println("传入的参数不是指针类型")
return
}
// 获取指针指向的元素
elem := v.Elem()
// 判断指向的元素是否为结构体
if elem.Kind() != reflect.Struct {
fmt.Println("指针指向的不是结构体")
return
}
// 获取元素的类型
t := elem.Type()
// 遍历字段
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
fieldValue := elem.Field(i)
fmt.Printf("字段名：%s, 字段值：%vn", field.Name, fieldValue.Interface())
}
}
func main() {
product := &Product{
ID: 1001,
Name: "笔记本电脑",
Price: 4999.00,
}
traverseStruct(product)
}
上述代码中，traverseStruct函数可以接收任意类型的参数，首先判断是否为指针，再判断指针指向的是否为结构体，最后完成字段遍历，适配了指针类型的结构体场景。
获取字段的标签信息
Golang的结构体字段支持添加标签，比如常见的json标签、form标签等，通过反射也可以获取到这些标签内容，这在通用序列化、参数绑定场景中非常实用：
package main
import (
"fmt"
"reflect"
)
type User struct {
Username string `json:"username" label:"用户名"`
Password string `json:"password" label:"密码"`
Email string `json:"email" label:"邮箱"`
}
func main() {
u := User{
Username: "test_user",
Password: "123456",
Email: "test@ipipp.com",
}
t := reflect.TypeOf(u)
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
// 获取json标签
jsonTag := field.Tag.Get("json")
// 获取label标签
labelTag := field.Tag.Get("label")
fieldValue := reflect.ValueOf(u).Field(i)
fmt.Printf("字段名：%s, json标签：%s, label标签：%s, 字段值：%vn", field.Name, jsonTag, labelTag, fieldValue.Interface())
}
}
注意事项
- 反射遍历只能获取到结构体的公开字段（首字母大写的字段），私有字段（首字母小写的字段）无法通过反射获取值，访问时会触发panic。
- 如果结构体字段的类型也是结构体，上述基础遍历只会获取外层结构体的字段，若需要递归遍历嵌套结构体的字段，需要额外判断字段的Kind是否为
reflect.Struct，再进行递归处理。 - 使用
fieldValue.Interface()获取字段值时，如果字段是私有字段，调用该方法会直接panic，因此遍历前需要确认字段的可见性。
常见应用场景
reflect遍历结构体字段的能力在很多通用场景中都有应用，比如：
- 实现结构体到map的通用转换，不需要为每个结构体单独编写转换逻辑。
- 通用的数据校验工具，遍历结构体字段，根据字段标签中的校验规则进行合法性校验。
- 通用的日志打印工具，自动打印结构体的所有字段名和对应值，不需要手动拼接输出内容。