Go中struct的map字段必须显式初始化，否则直接赋值或json.Unmarshal会panic；key需为可比较类型；嵌套map需注意初始化时机、JSON边界和key约束。
struct 里直接声明 map 字段会 panic
Go 的 map 是引用类型，但零值是 nil。结构体字段声明为 map[string]int 后，不显式初始化就直接赋值或遍历，会触发 panic: assignment to entry in nil map。
常见错误场景：定义结构体后直接调用 mymap["key"] = 1，或在 json.Unmarshal 前没初始化，反序列化失败。
- 必须在使用前用
make初始化，比如user.Permissions = make(map[string]bool) - 推荐在结构体初始化时一起做：
u := User{Permissions: make(map[string]bool)} - 如果结构体有多个 map 字段，漏掉任意一个都可能 runtime panic
json.Unmarshal 时 map 字段为空怎么办
Go 的 json 包不会自动为 nil map 分配内存——它只往已存在的 map 里写数据。如果结构体字段是 nil，即使 JSON 里有对应字段，反序列化后仍是空 map（len()==0），但不是 nil；如果 JSON 缺失该字段，则保持 nil。
- 安全做法：在结构体字段声明后加
json:",omitempty"并确保初始化，或统一在UnmarshalJSON方法里处理 - 更稳妥的是自定义
UnmarshalJSON方法，在方法开头检查并初始化：if s.Data == nil { s.Data = make(map[string]interface{}) } - 注意：
json.RawMessage可以绕过提前解码，但 map 字段仍需手动初始化
嵌套 map 的 key 类型限制和性能影响
Go 的 map key 必须是可比较类型（== 和 != 支持），所以不能用 []byte、slice、func、map 或含这些字段的 struct 作 key。
立即学习“go语言免费学习笔记（深入）”；
- 常见误用：
map[[]string]int编译报错：invalid map key type []string - 想用 slice 作 key？转成
string（如strings.Join）或用[32]byte这类固定数组 - 深层嵌套如
map[string]map[int][]string没语法问题，但每次访问都要多层指针跳转，GC 压力略高；若频繁读写，考虑扁平化 key（如"user_123_permissions"）
用 struct tag 控制 map 字段的 json 序列化行为
默认情况下，json.Marshal 会把 map 当作对象输出，key 是字符串，value 按其类型序列化。但 map 字段名本身不会出现在 JSON 中——它就是顶层对象。如果想控制 key 名、忽略空值或自定义编码逻辑，得靠 json tag 或方法。
-
type Config struct { Data map[string]string `json:"settings"` }—— 这个 tag 实际无效，因为 map 不走字段名映射，settings不会出现；真正起作用的是 map 的 key - 想让 map 的 key 全部小写？只能预处理 key 字符串，Go 标准库不提供全局 key 转换钩子
- 需要动态 key 名或条件过滤？重写
MarshalJSON方法，用json.NewEncoder手动写入
嵌套 map 看似简单，但初始化时机、JSON 边界、key 类型约束这三处最容易出错。别指望编译器帮你 catch nil map，它只在运行时摔你一跤。
