reflect.copy 不能用于深拷贝,因其仅支持 slice 和 array 的浅层复制,对 struct、map 等类型会 panic;标准库无 reflect.deepcopy;深拷贝需手动递归处理指针、结构体、map、slice 等,并避开不可导出字段。

为什么 reflect.Copy 不能直接用于深拷贝
reflect.Copy 只对 slice 和 array 生效,且仅执行浅层元素复制(即复制指针或值本身,不递归克隆嵌套结构)。对 struct、map 或含指针字段的对象调用它会 panic:panic: reflect.Copy: invalid destination type struct。深拷贝必须手动递归遍历每个字段,判断是否需分配新内存。
用 reflect.DeepCopy?不存在这个函数
Go 标准库中根本没有 reflect.DeepCopy。这是常见误解——很多人搜到过类似名字的第三方包或旧博客误导。标准 reflect 包只提供 reflect.Value.Copy(已废弃)和 reflect.Copy(如前所述,功能受限)。真正可行的反射深拷贝得自己写递归逻辑:
- 对
reflect.Ptr:新建指针,递归拷贝所指对象 - 对
reflect.Struct:遍历每个可导出字段,分别拷贝 - 对
reflect.Map:新建 map,键值都递归拷贝 - 对
reflect.Slice:用reflect.MakeSlice分配新底层数组,逐项赋值 - 跳过不可导出字段(私有字段无法通过反射写入)
深拷贝时最常踩的三个坑
写反射深拷贝函数时,以下问题几乎必现:
-
panic: reflect.SetMapIndex: value of type xxx is not assignable to type yyy—— map 的 key 或 value 类型不匹配,拷贝前没做类型检查或强制转换 - 无限递归:遇到循环引用(如 struct A 含 *B,B 又含 *A)未设 visited map 记录已处理地址,导致栈溢出
- 忽略接口值(
reflect.Interface):直接拷贝 interface{} 会丢失底层具体类型,需用.Elem()提取并递归处理其实际值
比手写反射更靠谱的替代方案
除非业务强依赖运行时动态类型,否则不建议在生产环境手写反射深拷贝。更稳的选择有:
立即学习“go语言免费学习笔记(深入)”;
- 用
encoding/gob序列化+反序列化:支持大部分类型,自动处理指针和循环引用(需注册),但要求所有字段可导出且类型可注册 - 用
github.com/jinzhu/copier:轻量、零依赖、支持 tag 控制(如copier:"-"跳过字段),内部仍用反射但已覆盖常见边界 case - 为关键结构体实现
Clone() *T方法:明确、可控、无反射开销,适合高频调用场景
手写反射深拷贝容易漏掉 map/slice 的容量保留、unsafe.Pointer 处理、time.Time 等特殊类型,上线后才发现某些字段没拷全,这类问题很难靠单元测试全覆盖。










