Go maps 包复制 map 并隔离写入的实现方式

需要复制一个 Go map 并在副本上继续改值时，优先使用 maps.Clone。它会创建新的 map 容器，所以新增、删除键以及修改标量值不会回写源 map；但它只是浅复制，值为 slice、指针或包含引用字段的结构体时，嵌套数据仍可能共享。先把这条边界分清，才能决定是否还要复制 value。

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

用 maps.Clone 复制 map 并隔离顶层写入

对 map[string]int、map[string]string 这类值本身是标量的 map，最小写法就是复制后只操作副本。maps.Clone 保留 map 的具体类型，目标 map 拥有自己的键集合和标量值槽位。

package main

import (
    "fmt"
    "maps"
)

func main() {
    source := map[string]int{
        "timeout": 10,
        "retries": 2,
    }

    // Clone 创建独立的顶层 map，后续增删改不触碰 source 的键集合。
    copied := maps.Clone(source)
    copied["timeout"] = 30
    delete(copied, "retries")
    copied["buffer"] = 256

    // 这里的 source 仍保留原值，copied 只承载本次修改。
    fmt.Println(source["timeout"], source["retries"])
    fmt.Println(copied["timeout"], copied["retries"], copied["buffer"])
}

这个写法适合“读取一份基础配置，再创建请求级覆盖项”的场景。判断是否需要更深复制时，不要看 map 的语法，而要看 value 的类型：整数、布尔值和字符串通常可以直接作为独立值使用；slice、map、指针则要继续检查引用关系。

浅复制的边界：map 的值是切片、指针时仍共享底层数据

官方文档将 Clone 明确为 shallow clone：新键和值通过普通赋值设置。因此外层 map 已经分开，不代表 value 指向的数据也分开。下面的示例中，两个 map 的键值槽不同，但两个 slice 的底层数组仍然可能是同一个。

package main

import (
    "fmt"
    "maps"
)

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

    // 这里只复制外层 map，slice value 仍按普通赋值共享底层数组。
    copied := maps.Clone(source)
    copied["ports"][0] = 8080

    // 修改 copied 的 slice 元素，也会观察到 source 的同一元素变化。
    fmt.Println(source["ports"])
    fmt.Println(copied["ports"])
}

这里最容易误判的是“修改 map 的键”和“修改键对应对象”不是一回事。执行 copied["new"] = ... 只影响副本的键集合；执行 copied["ports"][0] = ... 则沿着 slice 的引用进入共享数组。值为指针、map，或包含这些字段的结构体时，也应按同样的思路排查。

需要真正隔离嵌套数据时按值类型补一层复制

如果副本会改动 slice 内容，就在 Clone 外层 map 后逐项复制 slice。这样保留了 maps.Clone 对键集合的处理，同时把真正会变化的底层数组分开。以下函数只处理 map[string][]string，边界更清楚。

package main

import "maps"

func cloneLabels(src map[string][]string) map[string][]string {
    // 先隔离外层 map，避免新增或删除标签组影响 src。
    dst := maps.Clone(src)
    for key, labels := range dst {
        // 复制每个 slice 的元素，避免副本写入共享底层数组。
        dst[key] = append([]string(nil), labels...)
    }
    return dst
}

如果 value 是指针，应改为按业务字段创建新对象；如果结构体内部包含 slice 或 map，则要复制这些字段，而不是只复制结构体本身。深复制没有通用的 maps 一行函数，复制范围必须由数据模型决定。对于包含不可变值的 map，可以停在 Clone；只有副本会修改的引用对象才需要继续下钻。

区分 maps.Clone 与 maps.Copy 的使用边界

maps.Clone 返回一个新 map，适合“源数据保留不动，副本单独演化”；maps.Copy(dst, src) 则把源键值写入已有目标，目标中同名键会被源值覆盖。它不会替你创建一个全新的隔离目标，也不能解决嵌套 value 的共享问题。

常见问题

maps.Clone 会修改原 map 吗？

对顶层键集合和标量值不会。只要副本写入的是新的键槽，源 map 就不会跟着变化；但嵌套 slice、map 或指针对象仍要单独判断是否共享。

为什么 Clone 后改 slice，源 map 也变了？

因为 Clone 是浅复制，slice 的描述信息被复制了，但底层数组没有自动复制。复制每个 slice 的元素，或改用独立对象，才能隔离这类写入。

什么时候应该用 maps.Copy？

当目标 map 已经存在，并且你明确接受源键覆盖目标同名键时使用。若目标需要从源 map 完整复制出来，先用 Clone；若还要隔离嵌套数据，再按 value 类型补复制。