在Golang的开发场景中，我们经常会遇到需要动态处理对象属性的情况，比如将结构体转换为map、实现通用的数据校验逻辑、动态序列化对象等，这些场景都需要遍历对象的属性并获取对应的字段信息。Golang的reflect包提供了运行时反射能力，能够让我们在程序运行期间获取对象的类型信息和值信息，是实现对象属性遍历的核心工具。
reflect包核心类型说明
使用reflect包实现对象属性遍历前，需要先了解两个核心类型：reflect.Type和reflect.Value。reflect.Type用于获取对象的类型信息，比如结构体的字段名、字段类型、标签等；reflect.Value用于获取对象的值信息，能够读取和修改字段的具体值。
我们可以通过reflect.TypeOf()函数获取任意对象的reflect.Type，通过reflect.ValueOf()函数获取任意对象的reflect.Value。需要注意的是，如果要修改对象的字段值，传入reflect.ValueOf()的必须是指针类型，否则只能读取字段值无法修改。
基础对象属性遍历实现
下面我们通过一个具体的示例来演示如何遍历结构体的所有属性，首先定义一个测试用的结构体：
package main
import (
"fmt"
"reflect"
)
// 定义测试结构体
type UserInfo struct {
Name string `json:"name"`
Age int `json:"age"`
Score float64 `json:"score"`
IsActive bool `json:"is_active"`
}
func main() {
// 创建结构体实例
user := UserInfo{
Name: "张三",
Age: 25,
Score: 92.5,
IsActive: true,
}
// 获取对象的reflect.Type和reflect.Value
userType := reflect.TypeOf(user)
userValue := reflect.ValueOf(user)
// 判断是否为结构体类型
if userType.Kind() != reflect.Struct {
fmt.Println("传入的对象不是结构体")
return
}
// 遍历所有字段
fieldCount := userType.NumField()
for i := 0; i < fieldCount; i++ {
// 获取第i个字段的Type信息
field := userType.Field(i)
// 获取第i个字段的Value信息
fieldValue := userValue.Field(i)
// 输出字段名、字段类型、字段值、json标签
fmt.Printf("字段名: %sn", field.Name)
fmt.Printf("字段类型: %vn", field.Type)
fmt.Printf("字段值: %vn", fieldValue.Interface())
// 获取json标签，如果不存在则返回空字符串
jsonTag := field.Tag.Get("json")
fmt.Printf("json标签: %sn", jsonTag)
fmt.Println("-------------------")
}
}
上述代码运行后，会依次输出UserInfo结构体的四个字段的名称、类型、值和对应的json标签。这里需要注意，userValue.Field(i).Interface()方法用于获取字段的原始值，返回的是interface{}类型，我们可以根据实际类型做后续处理。
指针类型对象的属性遍历
实际开发中我们经常会传入结构体的指针，这时候需要先通过Elem()方法获取指针指向的实际元素，再进行属性遍历。修改上面的遍历逻辑，支持指针类型传入：
func TraverseStructFields(obj interface{}) {
objValue := reflect.ValueOf(obj)
// 如果是指针类型，获取指向的元素
if objValue.Kind() == reflect.Ptr {
objValue = objValue.Elem()
}
// 获取对应的Type
objType := objValue.Type()
// 判断是否为结构体
if objValue.Kind() != reflect.Struct {
fmt.Println("传入的对象不是结构体或结构体指针")
return
}
fieldCount := objType.NumField()
for i := 0; i < fieldCount; i++ {
field := objType.Field(i)
fieldValue := objValue.Field(i)
fmt.Printf("字段名: %s, 类型: %v, 值: %vn", field.Name, field.Type, fieldValue.Interface())
}
}
func main() {
user := UserInfo{
Name: "李四",
Age: 30,
Score: 88.0,
IsActive: false,
}
// 传入指针调用
TraverseStructFields(&user)
}
修改对象字段值的方法
如果要通过反射修改结构体的字段值，需要满足两个条件：第一，传入reflect.ValueOf()的是结构体指针；第二，要修改的字段必须是可导出的（字段名首字母大写）。下面是修改字段值的示例：
func ModifyStructField(obj interface{}, fieldName string, newVal interface{}) error {
objValue := reflect.ValueOf(obj)
// 必须是指针类型才能修改值
if objValue.Kind() != reflect.Ptr {
return fmt.Errorf("传入的对象必须是指针类型")
}
// 获取指针指向的元素
elemValue := objValue.Elem()
if elemValue.Kind() != reflect.Struct {
return fmt.Errorf("指针指向的对象不是结构体")
}
// 获取要修改的字段
fieldValue := elemValue.FieldByName(fieldName)
if !fieldValue.IsValid() {
return fmt.Errorf("不存在名为%s的字段", fieldName)
}
// 判断字段是否可修改（必须是导出字段）
if !fieldValue.CanSet() {
return fmt.Errorf("字段%s不可修改，可能是未导出字段", fieldName)
}
// 获取新值的reflect.Value
newValValue := reflect.ValueOf(newVal)
// 判断新值类型是否和字段类型匹配
if !newValValue.Type().AssignableTo(fieldValue.Type()) {
return fmt.Errorf("新值类型和字段类型不匹配")
}
// 设置新值
fieldValue.Set(newValValue)
return nil
}
func main() {
user := UserInfo{
Name: "王五",
Age: 22,
Score: 76.0,
IsActive: true,
}
// 修改Name字段
err := ModifyStructField(&user, "Name", "王五修改后")
if err != nil {
fmt.Println("修改失败:", err)
return
}
// 修改Age字段
err = ModifyStructField(&user, "Age", 23)
if err != nil {
fmt.Println("修改失败:", err)
return
}
fmt.Printf("修改后的用户信息: %+vn", user)
}
注意事项
- 反射操作会带来一定的性能损耗，如果不是必须动态处理对象的场景，尽量不要使用反射。
- 未导出的字段（首字母小写的字段）无法通过反射获取值或修改值，调用
FieldByName()获取未导出字段时，IsValid()会返回false。 - 获取字段值时，如果字段是指针类型，需要先通过
Elem()方法获取指针指向的实际值，再做后续处理。 - 通过
reflect.ValueOf()获取基本类型的反射值时，如果传入的是字面量，获取到的Kind()是对应基本类型，比如reflect.ValueOf(10).Kind()是reflect.Int。
常见应用场景
对象属性遍历的反射操作在实际开发中有很多应用场景，比如：
- 实现结构体到map的通用转换，不需要为每个结构体单独写转换逻辑。
- 实现通用的数据校验工具，遍历结构体字段，根据标签中的校验规则校验字段值。
- 实现ORM框架的对象映射逻辑，将数据库查询结果自动映射到结构体对象中。
- 实现通用的日志打印工具，自动打印结构体的所有字段和值，方便调试。