17370845950

反射修改结构体字段必须同时满足：字段可寻址（传指针并调用Elem）、导出（首字母大写）、可设置（CanSet为true）且类型匹配，否则Set系列方法会panic。

结构体字段必须是可寻址的

反射修改字段的前提是能拿到该字段的地址，否则 reflect.Value.Set* 系列方法会 panic，报错信息类似 reflect: reflect.Value.SetXxx using unaddressable value。这意味着你不能对字面量、函数返回值（非指针）、或从 map/slice 直接取出来的非指针元素做反射赋值。

实操建议：

• 传入结构体变量时，务必传 &structVar，而不是 structVar
• 若字段本身是 interface{} 或嵌套类型，也要确保其底层值可寻址（例如：interface{} 里装的是指针才可能修改）
• 用 v := reflect.ValueOf(x); if !v.CanAddr() { ... } 提前检查，避免运行时 panic

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

Go 的反射机制无法访问未导出字段（即小写字母开头的字段），即使你拿到的是指针，reflect.Value.FieldByName("name") 也会返回零值，且 .CanSet() 为 false。

常见错误现象：代码看似执行成功，但字段值没变；或者调用 field.SetXxx() 时 panic 报 reflect: cannot set unexported field。

实操建议：

• 确认目标字段名在结构体中是大写开头，如 Name string 可改，name string 不可改
• 不要依赖 json 标签名或自定义 tag 名来反射寻址——FieldByName 只认 Go 标识符名
• 若必须操作私有字段（仅限测试或极端调试），需用 unsafe + 指针偏移，但这是非标准、不可移植、极易崩溃的做法，不推荐

反射值必须是可设置的（CanSet 返回 true）

CanSet() 是关键守门员：它不仅要求字段导出，还要求整个反射链路没有“只读”断点。比如从 reflect.ValueOf(&s).Elem() 得到结构体值后，再用 .FieldByName() 获取字段，才可能 CanSet() == true。

性能与兼容性影响：反复调用 CanSet() 几乎无开销，但跳过它直接设值会导致 panic，尤其在泛型或动态字段名场景下容易漏判。

实操建议：

• 每次准备修改前都加判断：if !field.CanSet() { log.Fatal("cannot set field:", name) }
• 注意 reflect.ValueOf(s).FieldByName("X") 和 reflect.ValueOf(&s).Elem().FieldByName("X") 的区别：前者不可设，后者才可设
• 如果字段是接口类型（如 io.Reader），CanSet() 为 true 仅表示能替换整个接口值，不表示能修改接口内部的底层结构体字段

类型必须匹配或可赋值（assignable to）

反射设值不是类型转换。调用 field.SetString("abc") 前，字段类型必须是 string；用 field.Set(reflect.ValueOf(42)) 时，目标字段类型必须能接收 int（如 int、int64 不行，除非显式转换）。

常见错误现象：reflect: cannot convert int to string 或 reflect: cannot set *int to int。

实操建议：

• 优先使用类型专属方法（SetString、SetInt、SetBool），它们自动校验类型
• 若用通用 Set()，确保源 reflect.Value 类型与目标字段类型完全一致，或通过 .Convert() 显式转为目标类型的 reflect.Type
• 注意基础类型别名：若字段是 type MyInt int，则 int 值不能直接 Set，必须 Convert(reflect.TypeOf(MyInt(0)))

package main

import (
	"fmt"
	"reflect"
)

type User struct {
	Name string
	Age  int
}

func main() {
	u := User{Name: "Alice", Age: 30}
	v := reflect.ValueOf(&u).Elem() // 必须 Elem() 才能修改

	nameField := v.FieldByName("Name")
	if nameField.CanSet() {
		nameField.SetString("Bob")
	}

	ageField := v.FieldByName("Age")
	if ageField.CanSet() {
		ageField.SetInt(31)
	}

	fmt.Printf("%+v\n", u) // {Name:"Bob" Age:31}
}

反射修改字段真正卡住人的地方，往往不是语法写错，而是忘了最外层那个 &，或者把 ValueOf(s) 和 ValueOf(&s).Elem() 搞混。这两个条件缺一不可，且没有运行时提示——它直接 panic。