Go maps.Copy 复制到 nil map 为什么没有结果

maps.Copy 复制到 nil map 没有结果，根因是目标 map 没有可写的底层存储。nil map 可以安全读取，缺失键会得到值类型的零值；但任何向它写入键值的操作都不成立。解决方法不是给 maps.Copy 换一个参数顺序，而是在复制前用 make 创建目标 map：

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

dst := make(map[string]string)
maps.Copy(dst, src) // 目标已初始化，src 的键值才能写入 dst

nil map 为什么能读不能写

声明一个 map 变量但没有调用 make 时，它的值就是 nil。读取 nil map 不会 panic，因为运行时可以把“没有这个键”解释成零值；但是写入需要一个已经建立的哈希表存储，nil map 没有这个存储，所以直接赋值会触发运行时错误。

maps.Copy 的目标参数决定写入位置

maps.Copy(dst, src) 的第一个参数是被写入的目标，第二个参数是提供键值的源。它会遍历源 map，把键值放入目标；当目标中已有同名键时，源值覆盖目标值。这个函数不会替调用者重新绑定目标变量，也不会因为源 map 非 nil 就自动为 nil 目标分配存储。

package main

import (
    "fmt"
    "maps"
)

func main() {
    var dst map[string]string
    src := map[string]string{
        "mode": "safe",
        "port": "8080",
    }

    // nil map 没有可写存储，不能把复制结果放进去。
    fmt.Println(dst == nil, len(dst))

    // 先初始化目标，再把源 map 的键值复制到目标。
    dst = make(map[string]string)
    maps.Copy(dst, src)
    fmt.Println(dst["mode"], dst["port"])
}

这里的关键是给 dst 重新赋予一个由 make 创建的 map。若只是执行 maps.Copy(dst, src)，函数没有返回一个新的 map 供调用者接住，因此 nil 目标不会被“自动修复”。

配置合并时把初始化放在入口

这个问题最常出现在默认配置和用户配置合并。函数接收一个可能为 nil 的目标 map 时，建议在入口处初始化一次，然后按“默认值先进入、覆盖项后进入”的顺序复制。这样既保留了默认值，也让后续写入拥有稳定目标。

package config

import "maps"

// mergeLabels 返回可写的配置副本，并让 override 覆盖同名默认值。
func mergeLabels(defaults, override map[string]string) map[string]string {
    // make 后的结果始终可写，调用方传入 nil 也不会把 nil 传播出去。
    result := make(map[string]string, len(defaults)+len(override))

    // 先放默认配置，再放覆盖项，保证同名键由 override 最终决定。
    maps.Copy(result, defaults)
    maps.Copy(result, override)
    return result
}

如果业务语义要求“nil 与空 map 必须区分”，就不要在公共函数里无条件把 nil 转成空 map，而应先明确返回值契约。多数配置合并场景更关心结果可写和默认值覆盖，此时返回一个已初始化 map 会减少调用方的分支。

几个容易混淆的边界

• 复制方向：maps.Copy(dst, src) 不是把 dst 复制成一个新值，目标必须是你希望被修改的 map。
• 同键规则：src 中存在的同名键会覆盖 dst 当前值；src 里没有的键不会删除 dst 原有值。
• 空源 map：复制空 map 不会改变目标，也不会替目标初始化；目标是否为 nil 仍由调用方决定。
• 浅层复制：如果 value 是切片、指针或嵌套 map，复制的是 value 本身的引用语义，不会递归创建独立副本。

常见问题

把参数改成 maps.Copy(src, dst) 可以吗？

不可以。这样会把 dst 的内容写回 src，方向与“把配置覆盖项合并进结果”相反；而且 src 如果也是 nil，同样没有可写目标。

maps.Copy 会返回新的 map 吗？

不会。它直接修改传入的目标 map，没有返回值。需要新 map 时，先用 make 建立结果，再执行一次或多次复制。

目标 map 已经初始化但源 map 是 nil 呢？

源 map 为 nil 时没有可复制的键值，目标保持原样。这个场景不会替目标清空数据，也不会替目标新增初始化状态。