Go中reflect.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 < s.NumField(); i++ {
if !s.Field(i).CanInterface() {
continue
}
if s.Field(i).Type() == d.Field(i).Type() {
d.Field(i).Set(s.Field(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)而不是硬写反射逻辑——毕竟反射只是手段,不是目的。










