结构体字段必须首字母大写且通过指针传入才能用 reflect.Set 修改，需先调用 .Elem() 获取可寻址值，再用 .FieldByName() 和 .CanSet() 检查后调用对应 Set 方法。
结构体字段必须是可导出的才能用 reflect.Set 修改
Go 的反射机制无法修改未导出（小写开头）字段，reflect.Value.Set 调用会 panic，错误信息类似 reflect: reflect.Value.SetString on unaddressable value。根本原因是：只有可寻址（addressable）且可导出的字段才允许被修改。
实操建议：
- 确保结构体字段首字母大写（如
Name而非name） - 必须传入结构体指针（
&s），而非值拷贝（s），否则reflect.ValueOf(s)返回的是不可寻址的Value - 调用
.Elem()获取指针指向的结构体实例，再用.FieldByName()获取字段
正确使用 reflect.Value.Set 的三步流程
常见错误是跳过地址检查或类型转换，导致 panic 或静默失败。标准流程必须包含：
package main
import (
"fmt"
"reflect"
)
type User struct {
Name string
Age int
Email string
}
func main() {
u := User{Name: "Alice", Age: 30}
v := reflect.ValueOf(&u).Elem() // ✅ 取指针后解引用，得到可寻址 Value
// 修改字符串字段
if nameField := v.FieldByName("Name"); nameField.CanSet() {
nameField.SetString("Bob")
}
// 修改整数字段：注意类型匹配
if ageField := v.FieldByName("Age"); ageField.CanSet() {
ageField.SetInt(25)
}
fmt.Printf("%+v\n", u) // {Name:"Bob" Age:25 Email:""}
}
关键点：
立即学习“go语言免费学习笔记（深入）”；
-
.CanSet()必须显式检查，不能省略 - 赋值方法需匹配字段类型：
SetString()、SetInt()、SetFloat64()、SetBool()等 - 对
interface{}或自定义类型字段，需先用.Interface()转为具体类型再赋值，或用reflect.ValueOf(x)包装
修改嵌套结构体或 slice 字段的注意事项
嵌套字段不能直接用 FieldByName 一层取到，slice 字段也不能直接 Set 整个新 slice —— 必须逐项操作或替换底层 array。
例如修改 User.Profile.Nickname：
type Profile struct {
Nickname string
}
type User struct {
Name string
Profile Profile
}
// 正确方式：链式调用 Field，且每层都需 .Addr() 或保证可寻址
v := reflect.ValueOf(&u).Elem()
profileField := v.FieldByName("Profile")
if profileField.CanAddr() {
nicknameField := profileField.FieldByName("Nickname")
if nicknameField.CanSet() {
nicknameField.SetString("Zoe")
}
}
对 slice 字段（如 Tags []string）：
- 不能直接
tagsField.Set(newSlice)，除非newSlice是reflect.Value - 推荐做法：用
reflect.MakeSlice创建新 Value，再.Copy()或逐项.Index(i).SetString() - 若只是追加，可用
reflect.Append，但原 slice 必须来自指针且可寻址
reflect.Set 在 JSON 解析或 ORM 场景中的典型误用
很多人试图用反射批量给结构体字段赋值，却忽略零值覆盖、类型不匹配、时间字段解析失败等问题。比如从 map[string]interface{} 填充结构体时：
-
reflect.Value.SetString()对nil字符串字段 panic，应先判断field.Kind() == reflect.String && field.IsNil() -
time.Time字段不能直接SetString("2024-01-01")，需先解析成time.Time再用reflect.ValueOf(t).Convert(field.Type()) - JSON tag 名（如
json:"user_name"）和字段名不一致时，FieldByName失败，需遍历Type().Field(i)并比对Tag.Get("json")
真正健壮的字段填充逻辑，往往需要结合 reflect.StructTag、类型断言、零值检测，而不是只靠 Set。
最易被忽略的一点：reflect.Value.Set 不触发任何方法（如 setter、validate），也不会更新关联字段或触发钩子 —— 它只是内存位拷贝。如果业务逻辑依赖字段变更副作用，反射赋值后得手动补全。
