反射创建结构体必须用非指针类型调用reflect.New,返回指针;传*Type会panic;赋值需从reflect.New(t).Elem()开始确保可寻址,且字段必须导出。

反射创建结构体对象必须传入指针类型
用 reflect.New 创建对象时,传入的 reflect.Type 必须是结构体类型本身(非指针),但返回的是该类型的指针;若误传 *T 类型,会 panic:「panic: reflect: New(nil)」或「cannot use nil as type *T」。正确做法是先用 reflect.TypeOf(&T{}).Elem() 或 reflect.TypeOf(T{}).TypeOf() 拿到结构体类型,再传给 reflect.New。
常见错误场景:从字符串动态加载类型后直接 reflect.New(reflect.TypeOf("T")) —— 这里传的是 string 类型,不是目标结构体。
- ✅ 正确:
t := reflect.TypeOf(MyStruct{}); v := reflect.New(t).Interface() - ❌ 错误:
v := reflect.New(reflect.TypeOf(&MyStruct{})).Interface()(传了 *MyStruct 类型) - ⚠️ 注意:
reflect.New返回的是reflect.Value,需调用.Interface()才能得到真实 Go 对象
通过 reflect.Value.Set 赋值字段前必须可寻址且可设置
反射赋值字段(如 field.SetValue)失败,90% 是因为原始值不可寻址。例如 reflect.ValueOf(MyStruct{}) 得到的是不可寻址的副本,.Field(i).CanSet() 恒为 false。
解决路径只有一条:必须从指针开始 —— 先 reflect.New(t),再用 .Elem() 获取可寻址的 struct 值,然后遍历字段赋值。
立即学习“go语言免费学习笔记(深入)”;
- ✅ 可设值:
v := reflect.New(t).Elem(); v.FieldByName("Name").SetString("foo") - ❌ 不可设值:
v := reflect.ValueOf(MyStruct{}); v.FieldByName("Name").SetString("foo")(panic: reflect: cannot set) - ⚠️ 字段必须是导出字段(首字母大写),否则
FieldByName返回零值,CanSet()为 false
reflect.New 和 &T{} 在运行时行为差异明显
reflect.New 触发完整反射路径:查类型元数据、分配内存、初始化零值、返回 reflect.Value;而 &T{} 是编译期确定的直接构造,无反射开销,也不受运行时类型系统约束。
性能上,reflect.New 比 &T{} 慢 10–20 倍(实测小结构体),且无法内联、无法被逃逸分析优化。它唯一不可替代的场景是:类型在编译期未知,比如 ORM 映射、配置反序列化、插件系统中根据字符串名实例化。
- 用反射:仅当类型名来自字符串(如
map[string]reflect.Type查表)、或需统一工厂接口时 - 不用反射:已知具体类型时,永远优先写
&MyStruct{Field: val} - ⚠️ 注意:
reflect.New不会调用任何用户定义的构造函数或初始化逻辑,它只做零值分配
实例化含 unexported 字段或嵌套结构体时容易静默失败
反射对未导出字段(小写开头)完全不可见:v.NumField() 不包含它们,v.FieldByName("x") 返回无效值,.CanSet() 为 false —— 但不会报错,而是跳过或留零值,导致对象状态不完整。
嵌套结构体同理:若嵌套字段是未导出类型(如 type inner struct{...}),其字段无法被外层反射访问;若嵌套字段是导出类型但含未导出字段,则该字段本身可设,但其内部字段仍不可达。
- 调试技巧:打印
v.Kind() == reflect.Struct后,循环v.NumField()并检查每个v.Field(i).CanInterface()是否为 true - 补救方式:为关键未导出字段提供导出的 setter 方法,并用
v.MethodByName("SetX").Call(...)调用 - ⚠️ 最易忽略的一点:即使结构体字段是导出的,如果其类型本身是未导出的(如
data myInt),反射也无法对其赋值










