Go 怎样复制 map 并避免共享底层数据

配置快照或请求参数需要派生一份副本时，直接写 copied := original 往往不够：两个变量仍指向同一个 map 容器。Go 标准库的 maps.Clone 能创建新的 map 容器，适合复制键值结构；但它明确是浅复制，如果 value 是切片、map 或指针，底层对象仍可能被源 map 和副本共同引用。

官方资料：https://pkg.go.dev/maps

先分清 map 容器共享和 value 共享

map 变量本身不是一组内嵌键值字段。直接赋值后，original 和 alias 仍访问同一份底层 map；通过任一变量新增键或修改值，另一变量都能看到结果。这也是配置派生时最容易出现的“改了副本，原配置也变了”。

maps.Clone 的签名是 func Clone[M ~map[K]V, K comparable, V any](m M) M，返回与输入保持相同 map 类型的新容器。它适合先把键值对的外层结构隔离开，再决定 value 是否需要继续复制。

用 maps.Clone 复制标量 value

当 value 是整数、布尔值、字符串或只含值类型字段的结构体时，普通赋值语义已经能满足大多数隔离要求。下面的示例同时放出直接赋值和 maps.Clone 两种结果，重点是观察修改副本后的源 map。

package main

import (
	"fmt"
	"maps"
)

func main() {
	original := map[string]int{"retries": 2, "timeout": 30}
	alias := original
	clone := maps.Clone(original)

	// 直接赋值仍共享同一个 map 容器，修改 alias 会回写 original。
	alias["retries"] = 5
	// Clone 生成新的容器，修改 clone 不会改变 original 的键值。
	clone["timeout"] = 60

	fmt.Println(original["retries"]) // 5
	fmt.Println(original["timeout"]) // 30
	fmt.Println(clone["timeout"])    // 60
}

这里的“独立”是指 map 容器和每个 value 的赋值结果独立，不是承诺递归复制任意对象。若只保存配置数字和开关，maps.Clone 通常就足够；如果配置中嵌套了可变集合，继续看下一层。

识别浅复制仍共享的 value

切片 value 是最直观的边界。maps.Clone 会把切片头复制到副本 map，但切片头里的底层数组地址仍可能相同，所以修改副本中的元素也会影响源 map 中的切片。

package main

import (
	"fmt"
	"maps"
)

func main() {
	source := map[string][]int{"ports": {8080, 8443}}
	shallow := maps.Clone(source)

	// 只复制 map 外层，ports 对应的切片底层数组仍可能共享。
	shallow["ports"][0] = 9000
	fmt.Println(source["ports"][0]) // 9000

	// 需要隔离切片时，显式复制每个 value 的元素。
	deep := maps.Clone(source)
	deep["ports"] = append([]int(nil), source["ports"]...)
	deep["ports"][0] = 7000
	fmt.Println(source["ports"][0]) // 9000
	fmt.Println(deep["ports"][0])   // 7000
}

同样的判断适用于 value 为 map、指针、通道、函数，或结构体中嵌套这些引用型字段的情况。这里先别急着把所有对象都递归复制：深复制需要明确哪些字段允许共享、哪些字段必须独立，否则会增加成本却没有得到可验证的收益。

用边界清单决定是否继续深复制

我的检查顺序通常是：先测外层新增键是否影响源 map，再改一个嵌套 value，最后确认并发场景下是否还有共同写入者。测试不需要比较 map 的打印顺序，直接比较关键字段更稳定：

// 复制后分别修改外层和嵌套 value，验证隔离边界。
if got := original["timeout"]; got != 30 {
	t.Fatalf("source map changed: %d", got)
}
if got := deep["ports"][0]; got != 7000 {
	t.Fatalf("deep copy was not updated: %d", got)
}

如果 map 会跨 goroutine 同时读写，复制动作本身也不能替代同步；应在一致的临界区取得快照，再把快照交给只读消费者。maps.Clone 解决的是复制语义，不是并发保护。

相关问题

maps.Clone 是深复制吗？

不是。它复制新的 map 容器，并按普通赋值复制键和值；切片、map、指针等引用型 value 仍可能共享底层对象。

为什么 Clone 后修改切片还会影响源 map？

因为被复制的是切片头，不是它引用的底层数组。需要隔离时，先 Clone 外层 map，再为每个切片 value 分配并复制元素。

直接赋值和 maps.Clone 应该怎么选？

只想创建别名就直接赋值；需要独立的外层 map 容器就用 maps.Clone，然后依据 value 类型决定是否继续深复制。