Go中map必须用make或字面量初始化，未初始化的nil map写入会panic；删除键须用delete()而非赋零值；遍历顺序随机；并发读写需加锁或用sync.Map。

map 初始化必须用 make 或字面量，不能直接声明后赋值

Go 的 map 是引用类型，但不是指针，未初始化的 map 是 nil。对 nil map 写入会 panic：panic: assignment to entry in nil map。很多人在函数里只写 var m map[string]int 就开始 m["k"] = 1，结果一运行就崩。

• 正确方式只有两种：m := make(map[string]int) 或 m := map[string]int{"a": 1}
• 函数参数接收 map 时，传 nil 是合法的（只读场景），但只要涉及写入，调用方必须确保已初始化
• struct 字段定义 map 类型时，字段本身默认是 nil，需在构造函数或初始化逻辑中显式 make

删除键用 delete()，别用 m[key] = zeroValue

想删掉一个 key，写成 m["key"] = 0 看似清除了值，其实只是覆盖为零值，key 依然存在 —— len(m) 不变，range 还能遍历到它，且可能掩盖业务语义（比如 0 是有效值）。

• 唯一安全删除方式是 delete(m, "key")，它真正从底层哈希表移除该键值对
• delete() 对不存在的 key 安全，不报错也不做任何事
• 如果需要“逻辑删除”（保留 key 但标记无效），那是业务设计问题，不该依赖赋零值来实现

遍历 map 顺序不保证，别依赖 for range 的输出次序

Go 规范明确说明：每次 for range 遍历 map 的顺序是随机的。这不是 bug，是故意设计，用来防止程序员误把非确定行为当契约。你本地测试跑十次都一样，上线换机器/换版本就变了。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 需要固定顺序（比如调试打印、生成稳定 JSON），得先取 key 列表，排序后再遍历：keys := make([]string, 0, len(m)); for k := range m { keys = append(keys, k) }; sort.Strings(keys); for _, k := range keys { ... }
• 基准测试中若用 map 遍历做耗时对比，顺序差异可能导致缓存局部性不同，结果不可复现
• JSON 编码器（encoding/json）对 map 的输出顺序也是随机的，别假设字段顺序和代码里字面量一致

并发读写 map 会 crash，必须加锁或换 sync.Map

原生 map 非并发安全。多个 goroutine 同时读+写、或同时写，会触发 fatal error：fatal error: concurrent map writes 或更隐蔽的读崩溃（如迭代时被写入导致指针错乱）。

立即学习“go语言免费学习笔记（深入）”；

• 简单场景：用 sync.RWMutex 包一层，读用 RLock()，写用 Lock() —— 注意别在锁内做耗时操作
• 高频读、低频写且 key 分布广：考虑 sync.Map，但它不支持 len()、不支持遍历所有值、API 是弱类型的（interface{}），且实际性能未必比带锁普通 map 好
• 千万别用 “只读不写” 来自我安慰 —— 只要有一个 goroutine 在写，其他所有 goroutine 的读都必须同步

Go 的 map 表面简单，但初始化、删除、遍历、并发这四点，每一步都有反直觉的细节。最容易被忽略的是：**map 变量声明 ≠ 实例化，以及并发场景下“我以为没写其实写了”的隐式写入（比如 m[k] 读不存在的 key 会触发自动插入零值）**。