如何使用Golang反射构建通用拷贝函数_Golang reflect对象复制方法说明

Go语言需用reflect包手动实现深拷贝,通过递归处理指针、切片、map、结构体等类型,注意可寻址性、跳过未导出字段,并显式分配内存。

Go 语言本身不支持直接的深拷贝语法,但借助 reflect 包可以实现通用、类型无关的对象拷贝函数。关键在于区分浅拷贝与深拷贝逻辑,正确处理指针、切片、map、结构体嵌套等常见类型,并规避循环引用和不可寻址值等问题。

基础思路:递归遍历并重建值

通用拷贝的核心是用 reflect.Value 获取源值的底层信息,对每种类型做适配处理:

  • 基本类型(int、string、bool 等)直接 CopySet
  • 指针类型先解引用,递归拷贝后新建指针并赋值
  • 切片需新建底层数组,逐项递归拷贝元素
  • map 需新建 map,遍历 key-value 并递归拷贝
  • 结构体需遍历每个字段,跳过未导出字段(无法反射访问)
  • 接口类型需取出动态值再递归处理

注意可寻址性与副本创建方式

反射操作要求目标值可寻址(CanAddr()),否则无法调用 Set()。因此通用拷贝函数通常接收接口{},内部用 reflect.ValueOf(src).DeepCopy() 不可行(无此方法),必须手动构造新值:

  • reflect.New(t).Elem() 创建可寻址的零值副本
  • 或用 reflect.Zero(t) 得到不可寻址零值,再通过 reflect.Copy 或字段赋值填充
  • 对切片/Map 等引用类型,必须调用 MakeSlice/MakeMap 显式分配内存

简易深拷贝函数示例(无循环引用处理)

以下是一个轻量级、可运行的通用拷贝函数,支持大多数常见结构:

立即学习“go语言免费学习笔记(深入)”;

func DeepCopy(src interface{}) interface{} {
	v := reflect.ValueOf(src)
	if !v.IsValid() {
		return nil
	}
	return copyValue(v).Interface()
}

func copyValue(v reflect.Value) reflect.Value {
	switch v.Kind() {
	case reflect.Ptr:
		if v.IsNil() {
			return reflect.Zero(v.Type())
		}
		clone := reflect.New(v.Elem().Type())
		clone.Elem().Set(copyValue(v.Elem()))
		return clone
	case reflect.Slice:
		if v.IsNil() {
			return reflect.Zero(v.Type())
		}
		clone := reflect.MakeSlice(v.Type(), v.Len(), v.Cap())
		for i := 0; i < v.Len(); i++ {
			clone.Index(i).Set(copyValue(v.Index(i)))
		}
		return clone
	case reflect.Map:
		if v.IsNil() {
			return reflect.Zero(v.Type())
		}
		clone := reflect.MakeMap(v.Type())
		for _, key := range v.MapKeys() {
			val := v.MapIndex(key)
			clone.SetMapIndex(key, copyValue(val))
		}
		return clone
	case reflect.Struct:
		clone := reflect.New(v.Type()).Elem()
		for i := 0; i < v.NumField(); i++ {
			if !v.Field(i).CanInterface() { // 跳过未导出字段
				continue
			}
			clone.Field(i).Set(copyValue(v.Field(i)))
		}
		return clone
	case reflect.Interface:
		if v.IsNil() {
			return reflect.Zero(v.Type())
		}
		return copyValue(v.Elem())
	default:
		return reflect.ValueOf(v.Interface()) // 基本类型直接包装
	}
}

使用限制与优化建议

该方案适合配置结构体、DTO 等简单场景,但要注意:

  • 不支持函数、channel、unsafe.Pointer 等不可拷贝类型,运行时 panic
  • 不检测循环引用,深层嵌套可能栈溢出
  • 性能低于手写拷贝(反射开销大),高频场景建议用代码生成(如 copiergo-deepcopy
  • 若需生产级健壮性,推荐使用成熟库:github.com/mohae/deepcopygithub.com/jinzhu/copier

基本上就这些。反射拷贝不是银弹,但理解它能帮你快速应对临时性、多类型混合的数据复制需求。