Go标准库无reflect.DeepCopy,reflect.Copy仅支持切片;深拷贝需手动反射遍历+递归,注意导出性、可寻址性、循环引用及struct tag处理,性能差,仅适用于运行时类型未知等特殊场景。

Go反射实现深拷贝时,reflect.Copy 不能直接用
Go标准库的 reflect.Copy 只支持切片之间复制,对结构体、指针、嵌套字段完全无效。试图用它拷贝结构体只会 panic:reflect.Copy: type mismatch: struct != struct。真正能走通的路径是手动遍历字段 + 递归处理,核心靠 reflect.Value.Set 和 reflect.New 配合。
- 必须确保目标值可寻址(
reflect.Value.CanAddr()或用reflect.New(t).Elem()构造) - 源值和目标值字段名、类型、导出性(首字母大写)必须严格一致,否则跳过或 panic
- 遇到未导出字段(如
name string),reflect.Value.Field(i)返回零值且CanSet()为 false,无法赋值
用 reflect.DeepCopy?不存在这个函数
Go标准库没有 reflect.DeepCopy。这是常见误解,源于其他语言(如 Python 的 copy.deepcopy)习惯迁移。实际要自己实现,或依赖第三方包如 github.com/jinzhu/copier、golang.org/x/exp/maps(仅 map)、github.com/mohae/deepcopy(已归档但代码仍可用)。
-
copier.Copy(dst, src)支持结构体、切片、map,自动忽略不可导出字段,可注册自定义转换函数 - 自己写反射拷贝时,需区分
reflect.Ptr、reflect.Struct、reflect.Slice、reflect.Map类型分别处理 - 遇到循环引用(A → B → A)会无限递归,必须加访问缓存(
map[uintptr]reflect.Value)检测
结构体字段 tag 影响拷贝行为,比如 json: 或 copier:
原生反射不读取 struct tag,但像 copier 这类库会识别 copier:"skip"、copier:"must" 或 json:"name,omitempty" 来控制字段是否参与拷贝。如果你手写反射逻辑,需要显式解析 tag:
field := t.Field(i)
if tag := field.Tag.Get("copier"); tag == "skip" {
continue
}
if jsonTag := field.Tag.Get("json"); strings.HasPrefix(jsonTag, "-") {
continue
}
- 注意:tag 解析是字符串操作,
"json:\"-\""和"json:\"-,omitempty\""都应跳过 -
copier默认忽略json:"-"字段,但不会因json:"name"而重命名字段——拷贝仍是按字段名匹配,不是按 tag 名 - 自定义 tag 如
db:"id"对拷贝无影响,除非你主动解析并映射
性能差、易出错,什么情况下才该用反射拷贝
反射拷贝比直接赋值慢 10–100 倍,且编译期无法检查字段变更。只在以下场景合理:
- 运行时才知道结构体类型(如 ORM 查询结果泛型封装)
- 需要统一处理几十个结构体,且字段高度同构(如 DTO → Entity 层转换)
- 已有成熟封装(如
copier.Copy),且已压测验证性能达标
绝大多数情况,优先写显式赋值函数或用 go:generate 自动生成,例如:func CopyUserToAdmin(u *User) *Admin。反射是兜底手段,不是首选方案。字段多了之后,类型安全和可调试性远比少写几行代码重要。










