Go反射实现通用复制方法详解

Go语言标准库并未提供`reflect.DeepCopy`，其`reflect.Copy`仅支持切片复制，对结构体等复杂类型无效；实现通用深拷贝需手动结合反射遍历、递归处理及可寻址性校验，并谨慎应对未导出字段、循环引用和struct tag（如`copier:"skip"`或`json:"-"`）等细节，虽能解决运行时类型未知等特殊场景需求，但性能损耗大（慢10–100倍）、易出错且丧失编译期检查，因此仅建议在ORM泛型结果映射、高度同构DTO转换等有限场景下谨慎使用，日常开发更推荐显式赋值函数或代码生成工具以保障类型安全与可维护性。

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。反射是兜底手段，不是首选方案。字段多了之后，类型安全和可调试性远比少写几行代码重要。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。