深拷贝需彻底隔离副本与原结构体,推荐用encoding/gob实现无侵入深拷贝;copier适用于简单嵌套场景但默认不深挖指针内容;手写Clone()最可控但易漏new/make导致静默共享。

深拷贝必须绕过指针共享问题
Go 语言中直接赋值结构体是浅拷贝,只要结构体字段含 *T、map、slice、chan 或 func,新旧变量就会共享底层数据。修改副本里的指针所指向内容,原结构体也会被改——这不是“拷贝”,是“别名”。深拷贝的目标只有一个:让副本与原结构体完全独立,互不干扰。
推荐用 encoding/gob 实现无侵入深拷贝
这是标准库中唯一无需修改结构体定义、支持任意嵌套指针和复杂类型的方案。它把结构体序列化成字节流再反序列化,天然切断所有引用关系。注意:类型必须可被 gob 编码(字段需导出、不能含不可编码类型如 unsafe.Pointer 或未导出的函数)。
func DeepCopy(v interface{}) (interface{}, error) {
var b bytes.Buffer
enc := gob.NewEncoder(&b)
dec := gob.NewDecoder(&b)
if err := enc.Encode(v); err != nil {
return nil, err
}
var dst interface{}
if err := dec.Decode(&dst); err != nil {
return nil, err
}
return dst, nil
}-
gob不依赖 JSON 标签,也不要求实现MarshalJSON - 性能比
json略优(无字符串解析开销),但仍有序列化/反序列化成本 - 无法处理带循环引用的结构体(会 panic),需提前检测
用 github.com/jinzhu/copier 处理高频、简单嵌套场景
当结构体字段多为基本类型 + 单层指针或 slice,且你不想写重复的 Copy() 方法时,copier 是轻量选择。它通过反射自动递归拷贝,对 *T 字段默认做非空判断后新建值,但不会深挖 map/slice 内部的指针(除非显式启用)。
type User struct {
Name string
Age *int
Tags []string
Addr *Address
}
type Address struct {
City string
}
u1 := &User{
Name: "Alice",
Age: new(int),
Addr: &Address{City: "Beijing"},
}
u2 := &User{}
copier.Copy(u2, u1) // u2.Addr 是新分配的 *Address,但 u2.Age 和 u1.Age 指向同一 int
- 默认不深拷贝指针字段的指向内容(只复制指针本身),需加
copier.DeepCopy标签或调用copier.CopyWithOption - 不支持自定义拷贝逻辑(比如忽略某字段、转换时间格式),灵活性低于手写
- 反射开销在高频调用中明显,上线前建议压测
手写 Clone() 方法是最可控也最易出错的方式
当你需要精确控制每个字段行为(例如某些字段只读、某些要转换、某些需按条件跳过),或结构体含不可序列化字段(如 io.Reader、sync.Mutex),就必须手写。关键点:所有指针字段必须显式 new(T) 并赋值,所有 slice/map 要 make 后逐项拷贝。
立即学习“go语言免费学习笔记(深入)”;
func (u *User) Clone() *User {
if u == nil {
return nil
}
c := &User{
Name: u.Name,
Age: new(int),
Tags: make([]string, len(u.Tags)),
Addr: &Address{},
}
* c.Age = *u.Age
copy(c.Tags, u.Tags)
c.Addr.City = u.Addr.City
return c
}- 嵌套层级越深,漏掉某个
new或make就会导致静默共享 - 如果结构体含
sync.Mutex等非拷贝类型,必须跳过或重置(不能直接赋值) - 测试时务必验证:修改副本的指针字段内容,原结构体对应字段是否不变
真正麻烦的不是怎么选方案,而是忘记检查结构体里有没有未导出字段、循环引用、或带状态的非拷贝类型——这些都会让看似成功的深拷贝在运行时突然失效。










