Golang使用反射实现通用数据复制工具-Golang-PHP中文网

Golang使用反射实现通用数据复制工具

P粉602998670

发布： 2025-09-26 22:34:01

原创

242人浏览过

首先通过反射获取源和目标结构体的字段，遍历并匹配同名且类型兼容的导出字段，将源值复制到目标中。该方法支持跨类型、部分字段匹配，具备通用性，适用于Go语言中的结构体字段复制场景。

golang使用反射实现通用数据复制工具

在Go语言开发中，经常会遇到需要将一个结构体的字段值复制到另一个结构体的情况。虽然可以通过手动赋值或使用mapstructure等第三方库来实现，但借助反射（reflect包），我们可以编写一个通用、灵活的数据复制工具，支持跨类型、部分字段匹配的复制。

基本思路与核心逻辑

使用反射实现数据复制的核心是遍历源对象和目标对象的可导出字段（即大写字母开头的字段），如果字段名相同且类型兼容，则将源对象的值复制到目标对象中。这个过程不依赖具体类型，因此具备通用性。

关键点包括：

通过reflect.Value获取对象的可设置字段
判断字段是否存在且可设置（CanSet）
处理基础类型、指针、结构体嵌套等情况
避免对非导出字段进行操作

实现通用Copy函数

下面是一个简化但实用的通用复制函数示例：

立即学习“go语言免费学习笔记（深入）”；

func Copy(dst, src interface{}) error {
    dstVal := reflect.ValueOf(dst)
    if dstVal.Kind() != reflect.Ptr || dstVal.IsNil() {
        return fmt.Errorf("dst must be a non-nil pointer")
    }

    srcVal := reflect.ValueOf(src)
    if srcVal.Kind() == reflect.Ptr {
        srcVal = srcVal.Elem()
    }

    dstVal = dstVal.Elem()
    if dstVal.Kind() != reflect.Struct {
        return fmt.Errorf("dst must point to a struct")
    }

    srcType := srcVal.Type()
    dstType := dstVal.Type()

    for i := 0; i         srcField := srcVal.Field(i)
        srcFieldType := srcType.Field(i)

        if !srcFieldType.IsExported() {
            continue
        }

        dstField := dstVal.FieldByName(srcFieldType.Name)
        if !dstField.IsValid() || !dstField.CanSet() {
            continue
        }

        if srcField.Type().AssignableTo(dstField.Type()) {
            dstField.Set(srcField)
        } else if srcField.Type().Kind() == dstField.Type().Kind() &&
                srcField.Type().ConvertibleTo(dstField.Type()) {
            dstField.Set(srcField.Convert(dstField.Type()))
        }
    }
    return nil
}

该函数支持：

黑点工具

在线工具导航网站，免费使用无需注册，快速使用无门槛。

查看详情

源对象可以是指针或值
目标必须为非空指针指向结构体
自动跳过不可导出或无法设置的字段
支持类型完全匹配或可转换的情况（如int32转int64不行，但同种类基础类型可尝试转换）

使用示例

假设有两个结构体：

type User struct {
    Name string
    Age  int
}

type UserInfo struct {
    Name string
    Age  int32
}

调用方式：

u1 := User{Name: "Tom", Age: 25}
var u2 UserInfo
err := Copy(&u2, u1)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", u2) // 输出：{Name:Tom Age:25}

尽管Age类型不同，但由于都是整型且可通过Convert处理，在满足条件时能成功复制。