0

0

如何使用Golang实现结构体深拷贝_Golang reflect字段复制与对象创建方法

P粉602998670

P粉602998670

发布时间:2026-01-11 12:15:15

|

648人浏览过

|

来源于php中文网

原创

深拷贝不能直接用 copy() 或赋值,因为二者只做浅拷贝:对指针、切片、map、channel、func 等类型复制的是引用而非底层数据,导致原结构体与副本共享底层数组或哈希表,修改相互影响。

如何使用golang实现结构体深拷贝_golang reflect字段复制与对象创建方法

深拷贝为什么不能直接用 copy() 或赋值

Go 语言中,= 赋值和 copy() 都只做浅拷贝:对指针、切片、map、channel、func 类型字段,复制的是引用而非底层数据。一旦原结构体修改这些字段内容,副本也会被影响。

例如结构体含 []intmap[string]string 字段时,直接赋值后两边共用同一底层数组或哈希表。

  • 切片字段复制后,len/cap 独立,但 data 指针指向同一块内存
  • map 字段复制后,两个变量指向同一个哈希表,deletemap[key] = val 会互相干扰
  • 嵌套结构体中的指针字段(如 *Child)被复制后仍指向原对象

reflect 手动实现深拷贝的注意事项

标准库 reflect 可递归遍历字段并重建值,但需手动处理每种类型边界。这不是“一行解决”的方案,而是可控性高的底层路径。

关键点:

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

  • 必须区分 reflect.Ptrreflect.Slicereflect.Mapreflect.Structreflect.Interface 等类别,分别调用 reflect.New()reflect.MakeSlice()reflect.MakeMap() 等创建新实例
  • 遇到 nil 指针或空 map/slice 时,不能直接 reflect.Value.Elem(),否则 panic
  • 需要跳过不可导出字段(首字母小写),否则 reflect.Value.CanInterface() 返回 false,无法读取值
  • 循环引用(A → B → A)会导致无限递归,生产环境必须加 visited map 去重
func DeepCopy(v interface{}) interface{} {
	val := reflect.ValueOf(v)
	if !val.IsValid() {
		return nil
	}
	return deepCopyValue(val).Interface()
}

func deepCopyValue(v reflect.Value) reflect.Value {
	switch v.Kind() {
	case reflect.Ptr:
		if v.IsNil() {
			return reflect.Zero(v.Type())
		}
		newPtr := reflect.New(v.Elem().Type())
		newPtr.Elem().Set(deepCopyValue(v.Elem()))
		return newPtr
	case reflect.Slice:
		if v.IsNil() {
			return reflect.Zero(v.Type())
		}
		newSlice := reflect.MakeSlice(v.Type(), v.Len(), v.Cap())
		for i := 0; i < v.Len(); i++ {
			newSlice.Index(i).Set(deepCopyValue(v.Index(i)))
		}
		return newSlice
	case reflect.Map:
		if v.IsNil() {
			return reflect.Zero(v.Type())
		}
		newMap := reflect.MakeMap(v.Type())
		for _, key := range v.MapKeys() {
			newMap.SetMapIndex(key, deepCopyValue(v.MapIndex(key)))
		}
		return newMap
	case reflect.Struct:
		newStruct := reflect.New(v.Type()).Elem()
		for i := 0; i < v.NumField(); i++ {
			if !v.Field(i).CanInterface() { // 不可导出字段跳过
				continue
			}
			newStruct.Field(i).Set(deepCopyValue(v.Field(i)))
		}
		return newStruct
	default:
		return v
	}
}

更稳妥的选择:用 encoding/gobjson 序列化反序列化

如果结构体满足基本约束(字段可导出、无函数/通道/不支持类型),用序列化方式实现深拷贝更简单且天然规避循环引用问题(只要不显式传入带环对象)。

ARTi.PiCS
ARTi.PiCS

ARTi.PiCS是一款由AI驱动的虚拟头像生产器,可以生成200多个不同风格的酷炫虚拟头像

下载

对比:

  • gob:Go 原生格式,支持私有字段(需注册)、保留类型信息,但要求接收方类型完全一致;不支持 interface{} 中的未注册类型
  • json:通用、易调试,但丢失类型(如 int64 变成 float64)、不支持 time.Time 默认序列化、忽略不可导出字段
  • 两者都无法处理 unsafe.Pointerfuncchancomplex 等类型,遇到即 panic 或静默丢弃
func DeepCopyWithGob(src interface{}) (interface{}, error) {
	var buf bytes.Buffer
	enc := gob.NewEncoder(&buf)
	if err := enc.Encode(src); err != nil {
		return nil, err
	}
	dec := gob.NewDecoder(&buf)
	dst := reflect.New(reflect.TypeOf(src).Elem()).Interface()
	if err := dec.Decode(dst); err != nil {
		return nil, err
	}
	return dst, nil
}

实际项目中建议优先用第三方库 copierdeepcopier

手写 reflect 深拷贝容易漏掉 corner case,比如嵌套 interface{}、自定义 Unmarshaler 接口、泛型类型(Go 1.18+)等。成熟库已覆盖大部分场景。

例如 github.com/jinzhu/copier

  • 支持结构体字段名匹配(自动忽略大小写、下划线)
  • 可配置跳过字段、强制转换类型、处理 slice/map 元素级拷贝
  • 不依赖序列化,性能比 gob/json 更好
  • 但默认不处理循环引用,需自行控制输入

使用示例:

import "github.com/jinzhu/copier"

type User struct {
	Name string
	Tags []string
	Opts map[string]int
}

u1 := &User{Name: "a", Tags: []string{"x"}, Opts: map[string]int{"k": 1}}
u2 := &User{}
copier.Copy(u2, u1) // u2 是 u1 的深拷贝(Tags/Opts 内容独立)

真正难的不是“怎么拷”,而是“哪些字段该拷、哪些不该拷、要不要转换类型、有没有隐藏的指针别名”。这些细节在反射路径里全得自己兜底。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

177

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

336

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

78

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号