Go标准库没有reflect.DeepCopy是因为设计上拒绝实现:反射无法安全处理unsafe.Pointer、func、sync.Mutex等类型,易panic或静默错误;gob序列化是更稳妥的伪深拷贝方案。

为什么 reflect.DeepCopy 不存在
Go 标准库压根没提供 reflect.DeepCopy 这个函数,也不是漏了——是设计上就拒绝。反射能读字段、能新建结构体、能递归遍历,但“安全地复制一切”这事它不负责。比如 unsafe.Pointer、func 类型、带互斥锁的 sync.Mutex,一碰就 panic 或静默出错。你写的“通用克隆”,大概率在某个边缘 case 上崩得悄无声息。
用 gob 编码解码是最稳的“伪 Deep Copy”
它绕过反射的坑,靠序列化重建值,天然跳过不可导出字段、函数、不支持的类型(会报错而非崩溃),且对指针、切片、map 的嵌套引用关系处理得老实。
- 必须确保所有字段可导出(首字母大写),否则
gob直接忽略 - 不能含
chan、func、unsafe.Pointer,否则Encode报gob: type not serializable - 性能比纯反射慢 3–5 倍,但胜在行为可预测;小数据量(
- 示例:
func DeepCopy(v interface{}) interface{} { var buf bytes.Buffer enc := gob.NewEncoder(&buf) dec := gob.NewDecoder(&buf) enc.Encode(v) var dst interface{} dec.Decode(&dst) return dst }
自己写反射克隆时,reflect.Value.CanInterface() 是第一道闸门
很多“通用拷贝”代码一上来就 v.Interface(),结果遇到未导出字段直接 panic:“cannot interface with unexported field”。必须先检查可访问性,再决定跳过还是报错。
- 对
struct字段:用field.CanInterface()判断是否可读,不可读就 skip(别硬取) - 对
slice和map:用reflect.MakeSlice/reflect.MakeMap新建,再逐个SetMapIndex或Index().Set(),别用reflect.Copy——它只做浅拷贝 - 遇到
interface{}:先v.Elem()再判断底层类型,否则会把接口本身当空值复制 - 不处理
unsafe.Pointer和func:检测到就panic("uncloneable type"),比静默错误强
第三方库选 copier 还是 deepcopy?看你的容忍边界
github.com/jinzhu/copier 快、轻、支持 tag 映射,但它是“按字段名匹配 + 类型兼容”的浅层映射,不是真正 deep copy;github.com/mohae/deepcopy 才是反射实现的深度克隆,但它明确不支持 sync.* 类型,文档里写了“not safe for structs containing mutexes”。
立即学习“go语言免费学习笔记(深入)”;
- 如果你的 struct 含
sync.RWMutex,两个库都会复制出两个独立锁——逻辑上可能错,但至少不 panic -
copier.Copy(dst, src)要求dst是指针,src可以是值或指针;deepcopy.Copy(src)返回新值,不修改原值 - 别信 benchmark 里“快 20 倍”的宣传——那是跑在纯 string/int 字段上;一旦有嵌套 map/slice,差距缩到 1.5 倍内
真正难搞的从来不是怎么写,而是怎么定义“克隆成功”:是内存隔离?语义等价?还是只要不 panic 就算赢?这些得看你业务里下一个 panic 出现在哪一行日志里。










