Golang如何通过反射遍历结构体

在Golang开发中，反射是处理动态类型、动态操作数据的核心能力，其中通过反射遍历结构体的场景非常常见，比如序列化、字段校验、数据映射等需求都需要用到这个能力。反射包提供了获取类型信息和值信息的能力，让我们可以在不预先知道结构体具体定义的情况下，动态访问其所有字段。

Golang反射遍历结构体的核心原理

Golang的反射功能由内置的reflect包提供，遍历结构体的核心流程分为三步：首先将结构体实例转换为反射值对象，然后获取反射值对应的反射类型对象，最后通过类型对象获取字段列表，再逐个匹配获取每个字段的值。

需要注意的是，只有可导出的结构体字段（首字母大写）才能通过反射正常访问，不可导出的字段在遍历时会返回零值，且无法修改其值。

核心API说明

• reflect.ValueOf(interface{})：将任意类型的实例转换为反射值对象
• reflect.TypeOf(interface{})：将任意类型的实例转换为反射类型对象
• Type.NumField()：获取结构体类型的字段总数
• Type.Field(int)：根据索引获取第i个字段的结构体信息
• Value.Field(int)：根据索引获取第i个字段的反射值对象

基础遍历示例：读取结构体所有字段名和值

我们先定义一个简单的结构体，然后编写反射遍历的代码，输出所有字段的名称和对应的值。

package main

import (
	"fmt"
	"reflect"
)

// 定义测试结构体，包含不同类型的字段
type UserInfo struct {
	Name  string
	Age   int
	Score float64
	IsVip bool
}

func main() {
	// 创建结构体实例
	user := UserInfo{
		Name:  "张三",
		Age:   25,
		Score: 92.5,
		IsVip: true,
	}

	// 获取结构体的反射值对象
	value := reflect.ValueOf(user)
	// 获取结构体的反射类型对象
	valueType := value.Type()

	// 遍历所有字段
	for i := 0; i < valueType.NumField(); i++ {
		// 获取第i个字段的类型信息
		field := valueType.Field(i)
		// 获取第i个字段的值
		fieldValue := value.Field(i)

		// 输出字段名、字段类型、字段值
		fmt.Printf("字段名：%s，字段类型：%v，字段值：%vn", field.Name, field.Type, fieldValue.Interface())
	}
}

运行上述代码，会输出以下结果：

字段名：Name，字段类型：string，字段值：张三
字段名：Age，字段类型：int，字段值：25
字段名：Score，字段类型：float64，字段值：92.5
字段名：IsVip，字段类型：bool，字段值：true

进阶场景：遍历并修改结构体字段值

如果需要修改结构体字段的值，需要注意反射值对象必须是可寻址的，也就是传入reflect.ValueOf的必须是结构体指针，否则修改操作会触发panic。

package main

import (
	"fmt"
	"reflect"
)

type UserInfo struct {
	Name  string
	Age   int
	Score float64
}

func main() {
	user := UserInfo{
		Name:  "李四",
		Age:   20,
		Score: 88.0,
	}

	// 传入结构体指针，获取可寻址的反射值对象
	value := reflect.ValueOf(&user).Elem()
	valueType := value.Type()

	for i := 0; i < valueType.NumField(); i++ {
		fieldValue := value.Field(i)
		// 判断字段是否可修改
		if fieldValue.CanSet() {
			// 根据字段类型设置新值
			switch fieldValue.Kind() {
			case reflect.String:
				fieldValue.SetString("王五")
			case reflect.Int:
				fieldValue.SetInt(30)
			case reflect.Float64:
				fieldValue.SetFloat(95.5)
			}
		}
	}

	fmt.Printf("修改后的结构体：%vn", user)
}

运行结果如下，可以看到结构体字段已经被成功修改：

修改后的结构体：{王五 30 95.5}

遍历时的注意事项

1. 不可导出字段的处理

如果结构体中包含首字母小写的不可导出字段，反射遍历时虽然能获取到字段名，但无法读取和修改其值，调用fieldValue.Interface()会直接panic，因此遍历前可以通过fieldValue.CanInterface()判断是否可以安全读取。

2. 指针类型字段的处理

如果结构体字段是指针类型，需要先判断指针是否为空，再通过Elem()获取指针指向的实际值，否则直接调用Interface()可能会返回错误结果。

3. 性能问题

反射操作相比原生的字段访问会有一定的性能损耗，因此不要在高频调用的核心逻辑中大量使用反射遍历，非必要场景优先使用原生方式访问结构体字段。

常见错误排查

Golang反射结构体遍历reflect包修改时间：2026-06-10 17:24:35