最快上手但有坑:json.marshal/unmarshal仅处理导出字段,time.time转字符串,func/chan/unsafe.pointer等静默丢弃或panic;适用纯数据dto;copier更智能但不处理接口;自定义clone最可控;gob保留未导出字段但需注册且类型严格一致。

用 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.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),传指针更安全 - 遇到
nilslice/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的核心概念和高级技巧!











