Go maps 用 Clone 区分 nil 与空 map

如果业务需要区分“没有提供 map”和“提供了一个空 map”，复制时不要只看 len。Go 标准库的 maps.Clone 会保留源 map 的 nil 语义：nil map 克隆后仍是 nil，make 得到的空 map 克隆后仍是非 nil 空 map。这样既能保留输入状态，又能让非 nil 副本继续接受写入。

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

判断这类数据时，把 m == nil 当作“是否存在”，把 len(m) 当作“有多少元素”。需要保留这层区别时，用 maps.Clone，不要用“统一 make 一个新 map”的写法覆盖源状态。

先分清 nil map 和空 map

声明但没有初始化的 map 是 nil；make(map[string]int) 创建的是非 nil 空 map。两者的 len 都是 0，读取不存在的键也都会得到类型零值，但写入行为不同：nil map 不能直接写，非 nil 空 map 可以写。

package main

import "fmt"

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

	// len 只能说明元素数量，不能说明 map 是否已经初始化。
	fmt.Println(nilMap == nil, len(nilMap))
	fmt.Println(emptyMap == nil, len(emptyMap))

	// nilMap["mode"] = 1 // 不能这样写，会触发运行时 panic。
	emptyMap["mode"] = 1 // 非 nil 空 map 可以直接写入。
}

因此，接口入参、配置覆盖或 JSON 字段处理中，不能把“长度为 0”直接当成“没有传值”。先判断 m == nil，再根据业务决定是否补默认值。

用 maps.Clone 保留源 map 的状态

maps.Clone 返回与输入 map 类型相同的副本。对 nil map，它保留 nil；对非 nil 空 map，它返回一个新的非 nil map。这个行为特别适合“先复制，再在副本上补字段”的边界代码。

package main

import (
	"fmt"
	"maps"
)

func main() {
	var absent map[string]string
	provided := make(map[string]string)

	absentCopy := maps.Clone(absent)
	providedCopy := maps.Clone(provided)

	// == nil 观察输入状态；len 观察内容数量，两者职责不同。
	fmt.Println(absentCopy == nil, len(absentCopy))
	fmt.Println(providedCopy == nil, len(providedCopy))

	// 只有非 nil 副本可以直接写入，nil 副本仍需按业务决定是否 make。
	providedCopy["source"] = "default"
	fmt.Println(providedCopy["source"])
}

如果目标协议要求“缺失字段”和“空对象”不同，保留这个差异；如果协议只关心有没有键，则可以统一在边界层初始化。不要为了让后续代码好写，过早把 nil 变成空 map。

复制的是 map 外壳，不是所有 value

maps.Clone 是浅拷贝：键和值通过普通赋值放进新 map。修改新 map 的顶层键，不会改变原 map；但 value 如果是 slice、指针或包含引用的结构体，底层对象仍可能共享。

package main

import (
	"fmt"
	"maps"
)

func main() {
	original := map[string][]int{"ids": {1, 2}}
	clone := maps.Clone(original)

	// 新 map 的键集合独立，但 slice value 仍指向同一底层数组。
	clone["ids"][0] = 99
	fmt.Println(original["ids"][0]) // 99

	// 需要完全隔离时，要对嵌套 slice 再做一次复制。
	isolated := map[string][]int{"ids": append([]int(nil), original["ids"]...)}
	isolated["ids"][0] = 7
	fmt.Println(original["ids"][0]) // 99，外层 map 与嵌套 slice 都已分开
}

生产代码里的三个判断点

• 默认值：先用 m == nil 判断调用方是否提供，再决定补默认配置还是保留空对象。
• 写入：对 Clone 结果写入前确认它不是 nil；如果允许 nil 输入，显式 make 比隐式兜底更容易读。
• 并发：Clone 不是并发同步机制。复制时仍不能让一个 goroutine 同时写同一张 map；共享嵌套 slice 也要单独管理。

最后记住：maps.Equal 比较的是键值对，nil map 与非 nil 空 map 都没有键值时，不能用它判断二者身份。需要保留状态语义，就在比较前单独记录 nil 性。

相关问题

• Clone 后给 nil map 写入为什么仍会 panic？因为 nil 源的克隆结果仍是 nil，需要先按业务初始化。
• maps.Clone 会深复制结构体吗？不会。它只复制 map 的键和值；value 内部的 slice、指针等引用仍可能共享。
• len 为 0 能判断 map 是否为空对象吗？不能。要区分 nil 与非 nil 空 map，使用 m == nil。