Go maps.Copy 目标 map 为 nil 时为什么不会自动创建

调用 maps.Copy(dst, src) 时，如果 dst 是 nil，Go 不会替你调用 make。只要源 map 中有元素，复制过程就会在第一次写入时触发 panic: assignment to entry in nil map。正确做法是先初始化目标 map，再复制；如果初始化发生在函数内部，还要把新 map 返回给调用方。

nil map 为什么能读，却不能接收复制结果

map 的零值是 nil。它和空 map 一样，读取不存在的键会得到元素类型的零值，len(nilMap) 也返回 0；但语言规范把“新增元素”单独排除在外。这个差异正好解释了为什么下面的判断不会出错，而写入会出错：

var settings map[string]int

fmt.Println(len(settings))       // 0：读取长度是安全的
fmt.Println(settings["timeout"]) // 0：读取不存在的键得到零值
settings["timeout"] = 30         // panic：nil map 不能新增元素

因此，问题不在 maps.Copy 是否“支持 nil”，而在复制动作本质上需要向目标 map 写入键值。

maps.Copy 只复制键值，不替目标分配存储

官方文档对 maps.Copy 的定义是：把 src 的所有键值对添加到 dst；如果键已经存在，目标值会被源值覆盖。这个签名把目标 map 作为可写容器传入，并没有返回一个新 map，所以它不能把调用方手里的 nil 变量自动改成已分配的 map。

最后一行容易造成误判：空源 map 没有触发错误，不代表 nil 目标已经初始化。后续再写入时，仍然会 panic。

先 make 再 Copy，配置合并就有明确的所有权

最小可用写法是把目标 map 的创建放在复制之前。容量提示不是必须项，但用源 map 长度作为初始容量，能表达“这个容器准备承接当前数据”的意图：

package main

import (
    "fmt"
    "maps"
)

func cloneConfig(src map[string]int) map[string]int {
    // 先分配可写目标，避免 maps.Copy 写入 nil map。
    dst := make(map[string]int, len(src))
    // 源值覆盖同名目标键；这里目标刚创建，因此直接得到副本。
    maps.Copy(dst, src)
    return dst
}

func main() {
    src := map[string]int{"timeout": 30, "retries": 2}
    fmt.Println(cloneConfig(src))
}

如果目标本来已经有默认值，仍然可以先 make，再把默认值写入，最后执行 maps.Copy(dst, override)。同名键的优先级由复制顺序决定：后一次复制覆盖前一次。

函数参数里的初始化为什么不能自动改回调用方

下面的写法看起来像是修复了 nil，但调用方拿到的变量仍然是 nil：

func copyInto(dst, src map[string]int) {
    // 这里只改了函数参数这份 map 描述符，不会重绑调用方变量。
    if dst == nil {
        dst = make(map[string]int)
    }
    maps.Copy(dst, src)
}

map 参数按值传递。参数与调用方最初可能指向同一个底层 map，所以对“已有 map”的键值修改能被调用方看到；但把参数重新赋成 make 出来的新 map，只改变了函数内部的变量。需要让调用方拿到新容器时，直接返回它：

func mergeConfig(dst, src map[string]int) map[string]int {
    // nil 目标必须在函数内部创建，并通过返回值交给调用方。
    if dst == nil {
        dst = make(map[string]int, len(src))
    }
    maps.Copy(dst, src)
    return dst
}

常见问题

maps.Copy 会深拷贝 map 里的切片吗？

不会。键和值通过普通赋值复制；如果值本身是切片、指针或包含引用的结构，底层数据仍可能共享。

src 是 nil 时需要先 make 吗？

通常不需要。nil 源 map 可以被遍历，复制不到任何键；真正必须保证可写的是目标 map。

应该用 maps.Copy 还是手写 for 循环？

单纯合并同类型 map 时优先用 maps.Copy，意图更直接；需要过滤键、转换值或处理错误时，再使用手写循环。