反射实现对象浅拷贝技巧

本文深入解析了Go语言中利用反射实现结构体浅拷贝的原理、限制与实用技巧，指出reflect.Copy不适用于结构体而仅支持切片，真正可行的方式是遍历导出字段并逐个赋值，但需严格满足可寻址性、类型完全一致、字段导出及声明顺序匹配等条件；同时澄清reflect.DeepEqual仅用于比较而非拷贝，并对比了更安全高效的替代方案——如直接赋值（推荐日常使用）、unsafe.Copy（需谨慎验证内存布局）以及代码生成（适合字段动态变化场景），帮助开发者在性能、安全与可维护性之间做出明智权衡。

Go 里用 reflect.Copy 不能直接浅拷贝结构体

反射本身不提供“浅拷贝结构体”的原子操作。reflect.Copy 只适用于切片之间复制元素，对结构体直接调用会 panic：reflect.Copy: type mismatch: struct != struct。真正能走通的路径是遍历字段、逐个赋值——但必须确保源和目标字段可寻址、类型兼容、且不是不可寻址的临时值。

• 目标值必须是可寻址的（比如 &dst，不能是纯字面量或函数返回的临时结构体）
• 源字段必须导出（首字母大写），否则 reflect.Value.Field(i) 读不到值
• 同名字段类型必须完全一致（int 和 int64 不行，哪怕底层一样）
• 嵌套结构体字段会原样复制指针或值，这就是“浅”的本质：不会递归克隆内部指针指向的内容

reflect.DeepEqual 不是拷贝工具，别误用

常有人看到 reflect.DeepEqual 就以为它附带“构造相似对象”能力，其实它只做比较，返回 bool，不生成新值。想靠它反推拷贝逻辑，属于方向性错误。

• 它连源值都不修改，更不会构造目标值
• 它的实现绕过反射字段访问限制（比如能比较非导出字段），但这对拷贝毫无帮助
• 如果用来“验证拷贝结果”，要注意浮点数 NaN、func 类型、map/slice 的底层数组地址等细节，容易误判

手动反射浅拷贝的最小可行代码

核心就是用 reflect.Value.SetMapIndex / Set 等方法把源字段值写入目标对应字段。下面这段能跑通，但只处理导出字段：

func shallowCopy(src, dst interface{}) {
    s := reflect.ValueOf(src).Elem()
    d := reflect.ValueOf(dst).Elem()
    for i := 0; i 

• 调用时必须传指针：shallowCopy(&src, &dst)，否则 .Elem() 会 panic
• 字段顺序必须严格一致（struct 字段声明顺序），不能靠名字匹配；想按名拷贝得用 reflect.Type.FieldByName
• 遇到 nil 指针字段，s.Field(i) 是合法的，d.Field(i).Set(...) 也会正常赋 nil，这符合浅拷贝预期

比反射更稳的替代方案：直接赋值 or unsafe（慎用）

95% 的场景下，结构体字段少、稳定，直接写 dst.Field = src.Field 更快、更安全、IDE 能跳转、编译器能检查。反射只在字段动态变化（比如 ORM 映射、通用序列化中间件）时才值得引入。

• 如果真要极致性能且结构体无指针/非空接口字段，可用 unsafe.Copy（Go 1.20+），但必须确保内存布局完全一致：unsafe.Copy(unsafe.Slice(&dst, 1), unsafe.Slice(&src, 1))
• unsafe.Copy 对含 map/slice/func 字段的结构体无效，运行时会 panic
• 反射版本一旦字段增减，运行时报错；直接赋值是编译时报错，更早暴露问题

字段多又常变？那该考虑代码生成（go:generate + structfield）而不是硬写反射逻辑——毕竟反射只是手段，不是目的。

以上就是《反射实现对象浅拷贝技巧》的详细内容，更多关于的资料请关注golang学习网公众号！