Go maps.Clone 怎样复制映射而不共享底层状态

如果只是想得到一个可以独立增删键的 map，Go 的 maps.Clone 是最直接的写法：copy := maps.Clone(original)。它会创建新的 map 结构，之后对 copy 的键增删或替换，不会改变 original 的对应键；但它不是递归深复制，值中的 slice、指针或其他引用对象仍可能共享。

本文只讨论标准库 maps.Clone 的复制边界。官方说明见 https://pkg.go.dev/maps#Clone：Clone 返回的是浅复制，键和值按普通赋值写入新 map。

maps.Clone 复制了什么

maps.Clone 的核心结果可以分成两层理解：第一层是 map 容器本身被复制，第二层是每个键和值通过普通赋值放入新容器。前一层解决“修改副本的键是否影响源 map”，后一层决定嵌套值到底是否还共享。

它的签名是：

func Clone[M ~map[K]V, K comparable, V any](m M) M

其中 M ~map[K]V 允许带有相同底层 map 结构的自定义 map 类型参与调用，返回值仍然是 M。这意味着不需要先把自定义类型转换成普通 map 再复制。

最小示例：副本的键写入不会回到源 map

下面的例子先复制一个 map[string]int，再分别修改已有键和新增键。输出重点是：copy 的修改发生在新的 map 结构中。

package main

import (
	"fmt"
	"maps"
)

func main() {
	original := map[string]int{"timeout": 3}
	copyMap := maps.Clone(original)

	// 修改副本中的已有键，不应改变源 map。
	copyMap["timeout"] = 10
	// 新增键也只属于副本。
	copyMap["retries"] = 2

	fmt.Println(original) // map[timeout:3]
	fmt.Println(copyMap)  // map[retries:2 timeout:10]

这里不能用遍历顺序判断输出字符串的排列顺序，因为 map 的迭代顺序没有稳定保证。判断复制是否成功，应直接读取具体键，或比较键集合，而不是比较格式化后的整段 map 文本。

nil map 与空 map 要分开处理

maps.Clone(nil) 返回 nil。一个长度为零但已经分配的 map 则仍是非 nil 的空 map；两者都没有键，但后续能否直接赋值不同。

package main

import (
	"fmt"
	"maps"
)

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

	nilCopy := maps.Clone(nilMap)
	emptyCopy := maps.Clone(emptyMap)

	// nilCopy 保持 nil，不能直接写入；这里仅读取状态。
	fmt.Println(nilCopy == nil, len(nilCopy))
	// emptyCopy 是可写的空 map。
	emptyCopy["ready"] = 1
	fmt.Println(emptyCopy["ready"])

如果业务需要“总能得到可写 map”，不能只调用 Clone 后就直接写入。应先判断返回值是否为 nil，必要时用 make 创建一个新的 map。

浅复制：嵌套 slice 仍可能共享

最容易误解的地方是：map 结构独立，不代表每个值都深复制。对于 map[string]int，整数是值类型，替换副本中的整数不会影响源 map；对于 map[string][]int，slice 值包含指向底层数组的引用信息，Clone 只按普通赋值复制这个 slice 值。

package main

import (
	"fmt"
	"maps"
)

func main() {
	source := map[string][]int{"ports": {80, 443}}
	clone := maps.Clone(source)

	// Clone 只复制 slice 描述信息，嵌套元素仍可能落在同一底层数组。
	clone["ports"][0] = 8080
	fmt.Println(source["ports"][0]) // 8080

	// 需要完全隔离时，复制每个 slice 值，再放入新的 map。
	deep := make(map[string][]int, len(source))
	for key, values := range source {
		// append 到 nil 切片会分配新的底层存储，避免复用源 slice。
		deep[key] = append([]int(nil), values...)
	}
	deep["ports"][0] = 9090
	fmt.Println(source["ports"][0]) // 8080，deep 的修改不会再回写

上面的“深复制”只处理了这一层 []int。如果值里还有指针、map、interface 或自定义引用对象，就要继续按业务对象的可变部分设计复制逻辑，不能把 maps.Clone 当成通用 deep copy。

Clone、Copy 和手写复制怎么选

还要注意并发边界：Clone 不是并发快照协议。如果源 map 正在被其他 goroutine 写入，复制本身就可能触发并发读写问题。需要并发安全时，应在锁保护下复制，或改用明确的不可变数据交换方案。

常见问题

maps.Clone 会复制嵌套 map 吗？

不会递归复制。嵌套 map 作为值时只是普通赋值，仍可能与源值共享同一个嵌套 map。

Clone 后修改副本的整数为什么安全？

整数值本身不携带底层数组或对象引用。修改副本的整数只替换副本 map 中的值槽位。

为什么 Clone(nil) 不是一个可写的空 map？

因为 Clone 保留输入 map 的 nil 状态。若调用方要求可写结果，应在 nil 时显式创建 map。

记住一句话：maps.Clone 隔离的是 map 容器，不承诺递归复制值。先判断值类型，再决定是否需要额外复制。