Go map 遍历 nil map 写入如何处理

在 Go 里，var index map[string]int 得到的是 nil map。它不是“完全不能用”：读取不存在的键会得到元素类型的零值，len 返回 0，for range 也会自然结束；真正会出问题的是把键写回去。只要执行 index[key] = value，运行时就会因为 map 尚未初始化而 panic。

处理这类代码的关键，是把“遍历输入”和“向目标 map 写入”拆开：第一次写入前用 make 创建可写 map，空输入时也明确决定返回 nil map 还是空 map。下面用一个小型标签索引把边界串起来。

先把 nil map 的三种行为分清

nil map 的读取、长度计算和遍历都可以安全进行，但它仍然没有可写的底层存储。判断时不要只看“程序有没有进入 range”，因为 nil map 的 range 次数本来就是 0。

package main

import "fmt"

func main() {
	var counts map[string]int

	// nil map 读取不存在的键，结果是 int 的零值。
	fmt.Println(counts["go"], len(counts))

	// nil map 遍历 0 次，不会因为 range 本身 panic。
	for key, value := range counts {
		// 这里仅展示读取，不向 nil map 写入。
		fmt.Println(key, value)
	}
}

因此，看到结果为空时，先区分“没有元素”和“map 是 nil”。二者都可能让 len 为 0，但后者在写入时必须先初始化。

为什么遍历后写入会 panic

常见代码会在遍历输入切片时，把结果累加到一个尚未初始化的 map 中。panic 不来自 range，而来自赋值表达式的左侧 map 元素。

func buildIndex(labels []string) map[string]int {
	var index map[string]int
	for _, label := range labels {
		// 遍历本身安全，但下面的元素赋值要求 index 已经可写。
		index[label]++ // 运行时 panic: assignment to entry in nil map
	}
	return index
}

即使 labels 非空，问题也不是输入值，而是 index 仍为 nil。若输入恰好为空，循环不会进入，函数可能“看起来正常”，这会让错误延迟到下一次真正有数据的调用。

把 make 放在第一次写入之前

最直接的修复是在函数创建目标 map 时就初始化。这样即使输入为空，返回的也是空但非 nil map，调用方后续仍可以安全追加。

func buildIndex(labels []string) map[string]int {
	// make 创建可写 map；容量提示只是减少扩容，不限制最终大小。
	index := make(map[string]int, len(labels))
	for _, label := range labels {
		// 重复标签会在已有计数上累加。
		index[label]++
	}
	return index
}

如果业务需要保留 nil 语义，也可以只在确认存在第一条数据时初始化：

func buildIndexOrNil(labels []string) map[string]int {
	var index map[string]int
	for _, label := range labels {
		if index == nil {
			// 延迟到第一次真实写入前初始化，空输入仍返回 nil。
			index = make(map[string]int)
		}
		index[label]++
	}
	return index
}

两种写法都能避免 panic，区别只在返回契约：前者返回“空但可写”的 map，后者把“没有输入”表达为 nil。对外 API 更适合提前约定一种结果，避免调用方到处重复判断。

用一个小项目验收边界

把索引函数看成一个最小项目时，可以按三项验收：非空输入能累计重复项，空输入的返回语义稳定，调用方拿到结果后可以继续写入。

还要注意，nil map 与并发安全是两个问题。初始化 map 只能解决写入 nil map 的 panic，不能让多个 goroutine 同时读写普通 map 变得安全；并发场景需要额外的同步设计。

常见疑问

nil map 能不能 delete？

可以。对 nil map 调用 delete 是无操作，但这不代表后续赋值也安全。

应该用 nil map 还是空 map？

如果调用方需要继续写入或序列化结果，通常返回已用 make 初始化的空 map 更直观；只有“没有数据”和“有一个空集合”必须区分时，才保留 nil。

记住一句话：nil map 可以读，不能写；遍历不会替你初始化，第一次赋值之前必须明确创建可写 map。