反射修改结构体字段必须同时满足：字段可寻址（传指针并调用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。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 确认目标字段名在结构体中是大写开头，如
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("%+vn", u) // {Name:"Bob" Age:31} } 反射修改字段真正卡住人的地方，往往不是语法写错，而是忘了最外层那个 &，或者把 ValueOf(s) 和 ValueOf(&s).Elem() 搞混。这两个条件缺一不可，且没有运行时提示——它直接 panic。