JSON序列化反序列化最快上手但有坑:需字段可导出且类型支持,不支持func/chan等,性能差10–100倍;copier反射拷贝更通用但需注意nil切片/map;手写Clone最可控,须显式处理引用类型;sync.Mutex等不可拷贝类型应共享指针或重置。

用 json.Marshal + json.Unmarshal 最快上手但有坑
多数人第一反应是序列化再反序列化,确实能复制嵌套指针、切片、map,但必须满足:所有字段可导出(首字母大写)、类型支持 JSON 编解码。不支持 func、chan、unsafe.Pointer,遇到会 panic。
常见错误现象:json: unsupported type: func() 或空结构体字段被忽略(没加 json: tag 且字段小写)。
- 使用场景:配置结构体、DTO 传输、测试中快速造副本
- 性能影响:涉及反射和内存分配,高频调用时明显比浅拷贝慢 10–100 倍
- 兼容性注意:time.Time 会被转成字符串,
nilslice/map 变成空值,原语义丢失
示例:
var src MyStruct = MyStruct{Data: []int{1,2}, Info: &Info{Name: "a"}}
dst := MyStruct{}
_ = json.Unmarshal(json.Marshal(src), &dst) // dst.Data 和 dst.Info 是新副本
用 github.com/jinzhu/copier 处理含指针/嵌套结构的常规需求
这个库在 runtime 用反射做字段级深拷贝,自动处理 *T、[]T、map[K]V、interface{},比手写安全,也比 JSON 方案保留更多类型信息。
容易踩的坑:copier.Copy(dst, src) 要求 dst 是指针;对未初始化的 nil map/slice 不会自动 make,需提前分配或启用 copier.DeepCopy 模式。
- 使用场景:ORM 实体复制、API 层与 domain 层结构转换
- 参数差异:默认跳过零值字段,加
copier.CopyWithOption(&dst, &src, copier.Option{IgnoreEmpty: false})可覆盖 - 性能影响:比 JSON 快,但仍有反射开销;复杂嵌套下可能比手写 copy 函数慢 3–5 倍
手写 Clone() 方法才是可控性最强的方式
当结构体字段稳定、性能敏感或含不可序列化字段(如 sync.Mutex、http.Client)时,必须自己实现。Go 没有构造函数,所以习惯定义 Clone() *MyStruct 方法。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
关键点:每个引用类型字段都要显式 new/make/copy,尤其注意 nil 切片和 map 的边界情况。
- 常见错误现象:直接
dst.Slice = src.Slice→ 共享底层数组;dst.Map = src.Map→ 指向同一 map - 使用场景:核心模型、高频创建对象、需精确控制拷贝粒度(比如只深拷某几个字段)
- 示例中
copy(dst.Slice, src.Slice)要求 dst.Slice 已 make,否则 panic
示例:
func (s *MyStruct) Clone() *MyStruct {
c := &MyStruct{
Name: s.Name,
Data: make([]int, len(s.Data)),
Info: &Info{Name: s.Info.Name},
Meta: make(map[string]string),
}
copy(c.Data, s.Data)
for k, v := range s.Meta {
c.Meta[k] = v
}
return c
}
别忽略 sync.Mutex 和其他非拷贝字段
Go 规定 sync.Mutex、sync.RWMutex 等不能被拷贝(编译期报 cannot be copied),但 struct 里嵌了它,用上面任意方案都可能静默失败或 panic。
真正容易被忽略的是:即使你没显式写 mutex sync.Mutex,用了 http.Client、sql.DB 这类内部含 mutex 的类型,它们也不能深拷——这不是 bug,是设计使然。
- 正确做法:这类字段应设为指针,拷贝时只复制指针(即共享),或在 Clone 中置为
nil并重置 - 检查方式:运行
go vet会提示 “assignment copies lock value” - 如果结构体必须带 mutex 且要“隔离”,说明设计有问题,应拆分状态与行为
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










