技术教程

如何在Golang中实现结构体的深拷贝_Golang指针嵌套处理方法

作者:php中文网2026-01-12 00:00:00

深拷贝需彻底隔离副本与原结构体，推荐用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
}