maps Clone 与 Copy 处理 nil map 有什么区别

在 Go 里，maps.Clone 和 maps.Copy 都能处理 map，但它们解决的不是同一个问题：Clone 返回一个新的 map 值，Copy 则把键值写入调用方提供的目标 map。遇到 nil map 时，最容易忽略的差别是：Clone(nil) 会保留 nil，而 Copy 是否安全取决于目标 map 是否需要写入。

官方文档：https://pkg.go.dev/maps

需要“复制出一个独立的 map 容器”时用 maps.Clone；需要把源数据合并到已有目标时用 maps.Copy。Clone 会保留 nil，Copy 不会替你创建 nil 目标。

先把 nil map 和空 map 分开

两者都可以安全读取，len 也都是 0，但它们不是同一个状态。空 map 已经有一个可写的 map 容器，nil map 只有零值语义，直接赋值会 panic。

package main

import "fmt"

func main() {
	var nilMap map[string]int
	emptyMap := make(map[string]int)

	// len 对 nil map 和空 map 都返回 0，不能单独用它判断容器状态。
	fmt.Println(len(nilMap), len(emptyMap))
	fmt.Println(nilMap == nil, emptyMap == nil)

	// 读取不存在的键都得到值类型的零值；这里不会触发 panic。
	fmt.Println(nilMap["missing"], emptyMap["missing"])
}

因此，文章后面的比较要同时观察两个结果：返回值是否为 nil，以及目标 map 是否真的能承接赋值。

maps.Clone 会保留 nil 状态

maps.Clone 的输入和返回值类型相同。官方实现先判断输入是否为 nil；如果是，就直接返回 nil，否则才创建浅克隆容器。对本题来说，关键结果如下：

package main

import (
	"fmt"
	"maps"
)

func main() {
	var nilMap map[string]int
	emptyMap := make(map[string]int)

	clonedNil := maps.Clone(nilMap)
	clonedEmpty := maps.Clone(emptyMap)

	// Clone(nil) 仍然是 nil；Clone(非 nil 空 map) 仍然是可写的非 nil map。
	fmt.Println(clonedNil == nil)   // true
	fmt.Println(clonedEmpty == nil) // false

	// 非 nil 的克隆可以直接写入，且不会改变原 map 的键集合。
	clonedEmpty["mode"] = 1
	fmt.Println(len(emptyMap), len(clonedEmpty))
}

这里的“新 map”指新的容器，文章只比较 nil 与空 map 的状态，不把它延伸成嵌套值的深拷贝讨论。

maps.Copy 只负责向目标写入

maps.Copy(dst, src) 没有返回值。它遍历 src，把每个键和值赋给 dst；如果目标中已有同名键，源值会覆盖目标值。源是 nil 时没有键可遍历，因此调用本身不会改变目标。

package main

import (
	"fmt"
	"maps"
)

func main() {
	var nilSrc map[string]int
	dst := map[string]int{"keep": 1}

	// nil 源没有键值，Copy 不会清空或重建目标，目标仍保留原内容。
	maps.Copy(dst, nilSrc)
	fmt.Println(dst)

	src := map[string]int{"keep": 2, "new": 3}
	// 同名键由 src 覆盖，新键则追加到已有目标。
	maps.Copy(dst, src)
	fmt.Println(dst)
}

真正需要避开的坑：nil 目标遇到非空源

Copy 不会像 Clone 一样返回一个新容器。如果 dst 是 nil，而 src 有至少一个键，内部赋值就会触发对 nil map 的写入 panic。若源也是 nil，则因为没有任何写入，调用可以平稳结束。

package main

import "maps"

func copyIntoReadyMap(src map[string]int) map[string]int {
	var dst map[string]int

	// 先初始化目标，确保后续 Copy 的键值写入有可用容器。
	dst = make(map[string]int, len(src))
	maps.Copy(dst, src)
	return dst
}

func main() {
	// nil 源会得到可写的空目标；非 nil 源则正常复制所有键值。
	_ = copyIntoReadyMap(nil)
	_ = copyIntoReadyMap(map[string]int{"ready": 1})
}

如果业务要求“源为空时仍保持 nil”，可以先判断源，再决定返回 nil；如果业务要求结果一定可写，就统一创建目标后再 Copy。关键是不要把 Copy 当作 Clone 的另一种写法。

按目标选择 API

可以把判断压缩成一句话：Clone 关注“返回什么容器”，Copy 关注“往哪个容器写”。只比较 nil 与空 map 时，前者保留输入的 nil 状态，后者由目标容器承担写入责任。

常见追问

nil map 可以读取吗？

可以。读取不存在的键会得到对应值类型的零值，遍历 nil map 也不会产生元素；真正危险的是直接赋值。

空 map 和 nil map 的 len 一样吗？

都是 0，所以需要用 m == nil 区分是否为 nil，不能只看长度。

maps.Copy 会清空目标中多出来的键吗？

不会。它只添加或覆盖源中出现的键，不会删除目标中源没有的键。