Golang结构体深拷贝实现技巧

在 Go 中实现结构体深拷贝没有银弹方案，不同方法各有利弊：`json.Marshal/Unmarshal`上手最快但会静默丢弃未导出字段、`func`/`chan`等类型，并将`time.Time`转为字符串导致精度与语义损失；`copier`库智能处理常见引用类型却忽略接口字段且不支持循环引用；手动编写`Clone()`方法最安全可控，尤其适合含`sync.Mutex`或自定义逻辑的场景，但易因遗漏字段引入浅拷贝隐患；`gob`能保留未导出字段且性能较好，却要求类型严格一致、需显式注册，灵活性最低。真正关键的不是技术选型，而是先厘清业务需求——哪些字段必须隔离（如`[]byte`、`map`），哪些复制反而危险（如`*sql.DB`、`context.Context`），避免盲目深拷引发隐蔽bug。

用 json.Marshal + json.Unmarshal 最快上手但有坑

结构体含 time.Time、func、chan、unsafe.Pointer 或未导出字段时，json.Marshal 会静默丢弃或 panic。它只序列化导出字段，且要求所有嵌套类型可 JSON 编码。

适用场景：配置结构体、纯数据 DTO、临时调试拷贝，不涉及时间精度丢失或方法保留。

• 导出字段名必须首字母大写，否则被忽略
• time.Time 会被转成字符串，反序列化后是新对象但类型不变
• 嵌套的 map[string]interface{} 或 []interface{} 会变成 map[string]any，类型变宽
• 性能差：涉及内存分配 + 字符串编解码，比直接复制慢 5–10 倍

data := MyStruct{CreatedAt: time.Now(), Tags: []string{"a"}}
b, _ := json.Marshal(data)
var copy MyStruct
json.Unmarshal(b, &copy) // copy.CreatedAt 是副本，但不是同一底层数组

用 github.com/jinzhu/copier 处理常见引用类型字段

它能自动识别 slice、map、struct 并递归深拷贝，支持自定义字段映射和跳过逻辑，比手写 Copy() 方法省事得多。

注意：默认不拷贝未导出字段；对指针字段（如 *string）会解引用再拷贝，生成新指针指向新值；对接口字段（如 io.Reader）不做处理，原样赋值——这可能是你漏掉的共享点。

• 安装：go get github.com/jinzhu/copier
• 支持 copier.Copy(&dst, &src) 或 copier.Copy(dst, src)，传指针更安全
• 遇到 nil slice/map 会初始化为空容器，不是 nil
• 不支持循环引用，会栈溢出 panic

var dst MyStruct
copier.Copy(&dst, &src) // src 中的 []int、map[string]int 都变成独立副本

自己写 Clone() 方法最可控，但容易漏掉字段

当结构体字段少、类型稳定、且含特殊字段（如 sync.Mutex、http.Client）时，显式实现 Clone() 是唯一可靠方式。别依赖反射，它绕不开未导出字段访问限制，也处理不了自定义逻辑。

关键点：每个引用类型字段都要手动 new / make / copy；值类型字段可直接赋值；指针字段要判断是否为 nil 再解引用。

• slice：用 make([]T, len(src), cap(src)) + copy()
• map：用 make(map[K]V) + for k, v := range src { dst[k] = v }
• struct 字段：调用其 Clone() 或按相同规则展开
• 忘记处理某个 []byte 或 map[string]*Item 就等于留了个浅拷贝后门

func (s *MyStruct) Clone() *MyStruct {
    if s == nil {
        return nil
    }
    c := &MyStruct{
        Name: s.Name, // string 是值类型，直接赋
    }
    c.Data = make([]byte, len(s.Data))
    copy(c.Data, s.Data) // 必须 copy，否则共用底层数组
    c.Meta = make(map[string]string)
    for k, v := range s.Meta {
        c.Meta[k] = v
    }
    return c
}

用 gob 编码时要注意注册和兼容性

gob 能保留未导出字段（需在包内注册），也能处理 interface{} 和自定义类型，但它要求接收方类型与发送方完全一致，包括包路径。跨服务或长期存储时，字段增减会导致解码失败。

它比 json 快，比 copier 稳，但灵活性最低。适合单体应用内部、短期内存拷贝、或需要保留 nil map/slice 的场景。

• 必须先调用 gob.Register() 注册含未导出字段的 struct
• 不能用于不同 Go 版本间通信（编码格式可能微调）
• 不支持函数、channel、unsafe 指针，遇到就 panic
• 每次拷贝都要新建 bytes.Buffer 和 gob.Encoder/Decoder，开销比纯内存操作大

var buf bytes.Buffer
enc := gob.NewEncoder(&buf)
enc.Encode(src)
dec := gob.NewDecoder(&buf)
dec.Decode(&dst)

深拷贝真正难的不是选哪个方案，而是确认「哪些字段确实需要深拷」——比如 context.Context、*sql.DB、http.RoundTripper 这类对象，复制没意义，甚至危险。别一上来就全量深拷，先看字段用途。

以上就是《Golang结构体深拷贝实现技巧》的详细内容，更多关于的资料请关注golang学习网公众号！