Go 向结构体的 map 字段写入时出现 assignment to entry in nil map

结构体已经创建，读取 map 字段也没有报错，但第一次执行 c.values[key] = value 就出现 panic: assignment to entry in nil map。常见条件是结构体使用了零值，而其中的 map 字段还没有初始化。

这适用于 Go 的普通 map，包括结构体字段和函数内声明的 map。下面使用字符串值缩小示例；元素改成其他类型不会改变 nil map 的写入规则。

先区分 nil map 和已经初始化的空 map

在发生写入之前观察同一个字段：

fmt.Println(c.values == nil, len(c.values))

若结果是 true 0，字段仍是 nil。若结果是 false 0，它是可以写入的空 map。单看长度无法区分两者。nil map 可以读取，缺失键返回元素类型的零值，这也是前面的读取看起来正常的原因。

如果这一行发生的是空指针解引用，应先确认结构体指针本身是否为 nil。初始化字段不能修复一个不存在的接收者。检查堆栈中的实际写入点，也不要把另一个局部 map 已初始化当作该字段已初始化。

在第一次写入前创建，并保留后续内容

如果希望结构体零值可以直接使用，可以让写入方法负责初始化。下面是单 goroutine 场景的完整示例：

package main

import "fmt"

type Config struct {
    values map[string]string
}

func (c *Config) Set(key, value string) {
    if c.values == nil {
        c.values = make(map[string]string)
    }
    c.values[key] = value
}

func main() {
    var c Config
    c.Set("region", "east")
    c.Set("mode", "test")
    fmt.Println(c.values["region"], c.values["mode"])
}

按上述代码，预期输出为 east test。只有字段为 nil 时才创建 map，第二次调用会保留第一个键。不要把无条件创建放进每次调用：那会让字段指向一个新的空 map，旧键从这个字段中消失。

这里使用指针接收者，让首次初始化写回原结构体。若改成值接收者，方法操作的是结构体副本；原字段为 nil 时，新建 map 不会保存回原结构体。原字段已非 nil 时，副本又可能共享同一 map，这种差异容易掩盖问题。

如果项目要求所有对象都经过构造函数，也可以在构造时初始化字段。不过需要检查是否还有 var c Config 或结构体字面量绕过构造函数。允许零值使用时，在写入入口保留条件初始化更直接。

验证已有键没有丢失

修复后在开发环境覆盖两种入口：一个零值对象连续写入两个不同键；一个已有内容的对象再写入新键。两者都应保留之前的值，且首次写入不再触发该 panic。不要依赖 map 的打印顺序判断是否正确，应按键检查。

若 map 会被多个 goroutine 访问，初始化检查和写入都需要纳入同步设计，读取也要遵守同一规则。仅加 nil 判断并不能让普通 map 安全地并发读写。

这是内存对象的初始化修复，无需清空持久化配置或重置服务数据。提交前保留原代码；若新增写入逻辑导致行为变化，可以回退这次代码修改，但回退后仍需避开原来的 nil map 写入路径。