反射赋值前必须确保字段可寻址、导出、类型匹配且非空指针:需传指针并调用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 的封装机制强制约束,无法绕过:
立即学习“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 类型的可寻址 Valuetarget.FieldByName("Name").SetString("Bob")
数组、切片、map 字段同理,需按类型分别处理初始化与赋值逻辑,不能一概而论。
反射赋值真正麻烦的地方不在语法,而在每一步都要检查可寻址性、导出性、类型匹配和空指针——漏掉任一环节,运行时 panic 就在所难免。










