Go maps.Copy 怎样合并映射并覆盖同名键
在 Go 里把一份配置合并进另一份配置,最容易写反的不是循环,而是 maps.Copy 的参数方向。记住一句话:maps.Copy(dst, src) 会把 src 的键值写入 dst;同名键由 src 覆盖,src 的新键则追加到 dst。
官方地址:https://pkg.go.dev/maps#Copy
如果希望“新配置覆盖旧配置”,就把旧 map 放在第一个参数,把新 map 放在第二个参数。目标 map 必须先初始化,maps.Copy 不会替你 make 一个 nil map。
最小写法:src 写入 dst
下面的例子把默认配置放进 dst,把环境配置放进 src。两个 map 都是 map[string]string,其中 mode 同名,region 是源 map 独有的键。
package main
import (
"fmt"
"maps"
)
func main() {
// dst 是承接合并结果的目标,必须是可写的 map。
dst := map[string]string{
"mode": "safe",
"owner": "default",
}
src := map[string]string{
"mode": "fast",
"region": "cn",
}
// src 的值写入 dst;同名 mode 会被 src 的值覆盖。
maps.Copy(dst, src)
fmt.Println(dst)
}
这里真正改变的是 dst:最终包含 owner、region 和 mode,而 mode 的值来自 src。src 本身不会因为复制而被删除或清空。

覆盖方向和键集合怎么判断
把调用形式拆开看就不容易混淆:
dst:被修改的目标 map,也是最终结果所在的位置。src:提供键值的源 map,源中的值优先级更高。- 同名键:执行普通赋值,结果是
dst[key] = src[key]。 - 只出现在
src的键:被加入dst。 - 只出现在
dst的键:保持不动。
因此,合并后的键集合是两边键集合的并集,但值的来源不是对称的。若业务要求“旧值覆盖新值”,应反过来调用 maps.Copy(src, dst) 或者先明确一份新的目标 map,不能只交换变量名后凭感觉判断。
nil map 与空 map 不是一回事
遍历 nil map 是安全的,所以 nil 的 src 没有键可写入,调用不会产生新内容;但 nil 的 dst 没有可写的底层存储。只要 src 非空,写入 nil dst 就会触发 map assignment panic。
package main
import "maps"
func main() {
var dst map[string]int
src := map[string]int{"retries": 3}
// 先分配目标 map,避免把键值写入 nil map。
dst = make(map[string]int, len(src))
maps.Copy(dst, src)
}
容量提示 len(src) 只是初始化时的预估,不改变覆盖规则。若目标 map 可能为 nil,最稳妥的做法是先统一初始化,再调用 maps.Copy。

泛型 map 和 value 的浅复制边界
maps.Copy 接受底层类型为 map 的泛型 map,只要键类型可比较,源和目标的键值类型相容,就可以处理自定义 map 类型。它复制的是键和值的赋值结果,不会递归复制 value 指向的对象。
package main
import (
"fmt"
"maps"
)
type Labels map[string][]string
func main() {
dst := Labels{"role": {"api"}}
src := Labels{"role": {"worker"}}
// 同名键的整个 slice 值被 src 替换,但 slice 底层数据仍按普通赋值共享。
maps.Copy(dst, src)
dst["role"][0] = "job"
fmt.Println(dst["role"])
}
如果 value 是 slice、map 或指针,后续修改可能影响同一底层对象。需要完全独立的数据时,应针对 value 另做深复制;maps.Copy 只负责 map 层面的键值合并。
速查:什么时候用 maps.Copy
| 场景 | 写法 | 结果 |
|---|---|---|
| 新配置覆盖旧配置 | maps.Copy(old, newer) | 同名键采用 newer |
| 只追加一份 map | maps.Copy(dst, src) | src 独有键进入 dst |
| 目标可能为 nil | 先 make 再 Copy | 避免写入 panic |
| 需要深复制 value | Copy 后单独复制 value | 避免引用型数据共享 |
常见问题
maps.Copy 会返回一个新的 map 吗?
不会。它原地修改第一个参数 dst,调用结果没有返回值。
src 为空时会清空 dst 吗?
不会。空或 nil 的 src 没有可写入的键,dst 保持原样。
怎样让 dst 的旧值优先?
不要让源 map 覆盖已有键;可以先筛选不存在的键再赋值,或者调整合并顺序并明确最终承接结果的 map。
记住参数顺序、先初始化目标 map,再检查 value 是否需要深复制,maps.Copy 就足以覆盖大多数 map 合并场景。
Go debug.BuildInfo.Settings 怎样读取构建时注入的版本参数
- 上一篇
- Go debug.BuildInfo.Settings 怎样读取构建时注入的版本参数
- 下一篇
- Go math/big.Float.Rat 怎样把浮点值转为精确分数
-
- Golang · Go教程 | 37分钟前 | 标准库 · Go教程 · Go debug.BuildInfo BuildInfo.Settings 构建信息 debug.ReadBuildInfo VCS版本
- Go debug.BuildInfo.Settings 怎样读取构建时注入的版本参数
- 485浏览 收藏
-
- Golang · Go教程 | 45分钟前 | 标准库 · 并发编程 · Go教程 · Go swap CompareAndSwap Store Load sync/atomic.Bool 并发开关
- Go sync/atomic.Bool 怎样安全表示共享开关状态
- 346浏览 收藏
-
- Golang · Go教程 | 46分钟前 | 标准库 · 数据校验 · Go教程 · Go 数据校验 hash.Hash32 CRC-32 hash/crc32.NewIEEE ChecksumIEEE
- Go hash/crc32.NewIEEE 怎样计算 IEEE CRC-32 校验值
- 301浏览 收藏
-
- Golang · Go教程 | 55分钟前 | 并发 · 标准库 · Go教程 · Go 资源复用 并发初始化 sync.OnceValue sync.OnceValues panic传播
- Go sync.OnceValue 怎样安全初始化带返回值的资源
- 372浏览 收藏
-
- Golang · Go教程 | 57分钟前 | time · 时间处理 · Go教程 · UNIX时间 time.Duration Go time.Time.Round 时间戳区间取整 时间分桶
- Go time.Time.Round 怎样对时间戳做区间取整
- 412浏览 收藏
-
- Golang · Go教程 | 59分钟前 | 标准库 · 时区 · 时间处理 · Go教程 · Go 时区 time.LoadLocation time.FixedZone time.Time.Zone UTC偏移
- Go time.Time.Zone 怎样同时读取时区名称和偏移秒数
- 328浏览 收藏
-
- Golang · Go教程 | 1小时前 | int · Go教程 · 有理数 Go math/big.Rat.Num big.Int.Set 分子引用 独立副本
- Go math/big.Rat.Num 返回的分子怎样复制后独立修改
- 444浏览 收藏
-
- Golang · Go教程 | 1小时前 |
- Go sort.SearchInts 在有序整数切片中定位边界的实现方式
- 389浏览 收藏
-
- Golang · Go教程 | 1小时前 | 标准库 · 正则表达式 · Go教程 · 兼容性 · 正则表达式 Go POSIX ERE regexp.CompilePOSIX leftmost-longest
- Go regexp.CompilePOSIX 怎样使用 POSIX 正则语义
- 189浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1102次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1097次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1268次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1208次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1053次使用
-
- Golang迭代如何在Go中循环数据结构使用详解
- 2022-12-22 148浏览
-
- 详解如何在Go语言中循环数据结构
- 2022-12-22 406浏览
-
- GScript 编写标准库示例详解
- 2022-12-30 369浏览
-
- 关于Golang标准库flag的全面讲解
- 2023-02-25 344浏览
-
- Go语言数据结构之双链表学习教程
- 2022-12-30 280浏览

