Golang反射设置结构体字段值_Go语言反射赋值示例_技术教程

反射赋值前必须确保字段可寻址、导出、类型匹配且非空指针：需传指针并调用Elem()，字段名首字母大写，Set方法须与字段类型严格一致，指针/嵌套字段需手动解引用并判空。

反射赋值前必须确保字段可寻址

Go 的 reflect.Value 只有在可

寻址（addressable）时才能调用 Set* 方法，否则会 panic：「reflect: reflect.Value.SetXxx called on non-settable reflect.Value」。常见错误是直接对结构体字面量或函数参数做反射赋值，比如 reflect.ValueOf(MyStruct{}) 返回的是不可寻址的副本。

正确做法是传入指针并用 Elem() 获取其指向的可寻址值：

type Person struct {
    Name string
    Age  int
}

p := &Person{}
v := reflect.ValueOf(p).Elem() // ✅ 可寻址
v.FieldByName("Name").SetString("Alice")
v.FieldByName("Age").SetInt(30)

字段必须是导出的（首字母大写）

即使结构体指针可寻址，若字段未导出（如 name string），FieldByName 仍返回零值 reflect.Value，调用 SetString 会 panic：「reflect: call of reflect.Value.SetString on zero Value」。

反射只能访问导出字段，这是 Go 的封装机制强制约束，无法绕过：

字段名必须首字母大写（Name，不是 name）
结构体本身也需导出（type Person struct，不是 type person struct）
嵌套结构体字段同理，逐层检查导出性

类型匹配失败会导致 panic

SetString、SetInt 等方法要求目标字段类型严格匹配。例如对 int64 字段调用 SetInt(42) 会 panic：「reflect: cannot set int using int64」；对 *string 字段调用 SetString 同样失败——它只接受 string 类型字段。

安全做法是先检查字段类型再调用对应方法：

v := reflect.ValueOf(p).Elem().FieldByName("Age")
if v.Kind() == reflect.Int {
    v.SetInt(25)
} else if v.Kind() == reflect.Int64 {
    v.SetInt(25) // ❌ 错误：SetInt 不接受 int64 值
    v.SetInt64(25) // ✅ 正确
}

更健壮的方式是用 Convert 转换后再设值，但需确保目标类型兼容（如 int → int64 可转，string → int 不可转）。

嵌套结构体和指针字段需手动解引用

如果字段是结构体指针（如 User *User），FieldByName 返回的是 *User 类型的 reflect.Value，不能直接对其调用 SetString。必须先判断是否为指针、是否为 nil、再 Elem() 获取实际值。

典型处理链：

field := v.FieldByName("User")
if field.Kind() == reflect.Ptr && field.IsNil() { field.Set(reflect.New(field.Type().Elem())) }
target := field.Elem() // 现在 target 是 User 类型的可寻址 Value
target.FieldByName("Name").SetString("Bob")

数组、切片、map 字段同理，需按类型分别处理初始化与赋值逻辑，不能一概而论。

反射赋值真正麻烦的地方不在语法，而在每一步都要检查可寻址性、导出性、类型匹配和空指针——漏掉任一环节，运行时 panic 就在所难免。