深拷贝不能直接用 copy() 或赋值,因为二者只做浅拷贝:对指针、切片、map、channel、func 等类型复制的是引用而非底层数据,导致原结构体与副本共享底层数组或哈希表,修改相互影响。

深拷贝为什么不能直接用 copy() 或赋值
Go 语言中,= 赋值和 copy() 都只做浅拷贝:对指针、切片、map、channel、func 类型字段,复制的是引用而非底层数据。一旦原结构体修改这些字段内容,副本也会被影响。
例如结构体含 []int 或 map[string]string 字段时,直接赋值后两边共用同一底层数组或哈希表。
- 切片字段复制后,
len/cap独立,但data指针指向同一块内存 - map 字段复制后,两个变量指向同一个哈希表,
delete或map[key] = val会互相干扰 - 嵌套结构体中的指针字段(如
*Child)被复制后仍指向原对象
用 reflect 手动实现深拷贝的注意事项
标准库 reflect 可递归遍历字段并重建值,但需手动处理每种类型边界。这不是“一行解决”的方案,而是可控性高的底层路径。
关键点:
立即学习“go语言免费学习笔记(深入)”;
- 必须区分
reflect.Ptr、reflect.Slice、reflect.Map、reflect.Struct、reflect.Interface等类别,分别调用reflect.New()、reflect.MakeSlice()、reflect.MakeMap()等创建新实例 - 遇到
nil指针或空 map/slice 时,不能直接reflect.Value.Elem(),否则 panic - 需要跳过不可导出字段(首字母小写),否则
reflect.Value.CanInterface()返回 false,无法读取值 - 循环引用(A → B → A)会导致无限递归,生产环境必须加 visited map 去重
func DeepCopy(v interface{}) interface{} {
val := reflect.ValueOf(v)
if !val.IsValid() {
return nil
}
return deepCopyValue(val).Interface()
}
func deepCopyValue(v reflect.Value) reflect.Value {
switch v.Kind() {
case reflect.Ptr:
if v.IsNil() {
return reflect.Zero(v.Type())
}
newPtr := reflect.New(v.Elem().Type())
newPtr.Elem().Set(deepCopyValue(v.Elem()))
return newPtr
case reflect.Slice:
if v.IsNil() {
return reflect.Zero(v.Type())
}
newSlice := reflect.MakeSlice(v.Type(), v.Len(), v.Cap())
for i := 0; i < v.Len(); i++ {
newSlice.Index(i).Set(deepCopyValue(v.Index(i)))
}
return newSlice
case reflect.Map:
if v.IsNil() {
return reflect.Zero(v.Type())
}
newMap := reflect.MakeMap(v.Type())
for _, key := range v.MapKeys() {
newMap.SetMapIndex(key, deepCopyValue(v.MapIndex(key)))
}
return newMap
case reflect.Struct:
newStruct := reflect.New(v.Type()).Elem()
for i := 0; i < v.NumField(); i++ {
if !v.Field(i).CanInterface() { // 不可导出字段跳过
continue
}
newStruct.Field(i).Set(deepCopyValue(v.Field(i)))
}
return newStruct
default:
return v
}
}
更稳妥的选择:用 encoding/gob 或 json 序列化反序列化
如果结构体满足基本约束(字段可导出、无函数/通道/不支持类型),用序列化方式实现深拷贝更简单且天然规避循环引用问题(只要不显式传入带环对象)。
对比:
-
gob:Go 原生格式,支持私有字段(需注册)、保留类型信息,但要求接收方类型完全一致;不支持interface{}中的未注册类型 -
json:通用、易调试,但丢失类型(如int64变成float64)、不支持time.Time默认序列化、忽略不可导出字段 - 两者都无法处理
unsafe.Pointer、func、chan、complex等类型,遇到即 panic 或静默丢弃
func DeepCopyWithGob(src interface{}) (interface{}, error) {
var buf bytes.Buffer
enc := gob.NewEncoder(&buf)
if err := enc.Encode(src); err != nil {
return nil, err
}
dec := gob.NewDecoder(&buf)
dst := reflect.New(reflect.TypeOf(src).Elem()).Interface()
if err := dec.Decode(dst); err != nil {
return nil, err
}
return dst, nil
}
实际项目中建议优先用第三方库 copier 或 deepcopier
手写 reflect 深拷贝容易漏掉 corner case,比如嵌套 interface{}、自定义 Unmarshaler 接口、泛型类型(Go 1.18+)等。成熟库已覆盖大部分场景。
例如 github.com/jinzhu/copier:
使用示例:
import "github.com/jinzhu/copier"
type User struct {
Name string
Tags []string
Opts map[string]int
}
u1 := &User{Name: "a", Tags: []string{"x"}, Opts: map[string]int{"k": 1}}
u2 := &User{}
copier.Copy(u2, u1) // u2 是 u1 的深拷贝(Tags/Opts 内容独立)
真正难的不是“怎么拷”,而是“哪些字段该拷、哪些不该拷、要不要转换类型、有没有隐藏的指针别名”。这些细节在反射路径里全得自己兜底。










