Go中map必须显式初始化（如make或字面量）才能赋值，nil map写入会panic；原生map非线程安全，并发读写需sync.Map、sync.RWMutex或channel保护；key类型必须可比较，切片/map/函数等不可作key；make容量不能为负或过大。
map未声明就直接赋值
Go 中 map 是引用类型，但声明后默认值为 nil，此时不能直接写入。常见错误是只写了 var m map[string]int 或 m := make(map[string]int, 0) 漏掉 make，结果运行时报 panic: assignment to entry in nil map。
正确做法必须显式初始化：
var m map[string]int
m = make(map[string]int) // ✅ 必须这一步
// 或一步到位
m := make(map[string]int)
// 或用字面量（也隐含初始化）
m := map[string]int{"a": 1}
注意：声明 + 赋值分开写时，漏掉 make 是高频低级错误；用短变量声明 := 时，若右侧没调用 make 或字面量，m 会是其他类型（比如 nil 指针），不是 map。
并发写入未加锁导致 panic
Go 的原生 map 不是线程安全的。多个 goroutine 同时写（或一读一写）会触发运行时检测，直接 panic: concurrent map writes，且无法 recover。
立即学习“go语言免费学习笔记（深入）”；
典型场景包括：
- for 循环启动多个 goroutine 写同一个
map - HTTP handler 共享一个全局
map但没同步控制
解决方式有三种：
- 用
sync.Map（适合读多写少、key 类型为string或interface{}的场景） - 用
sync.RWMutex手动保护普通map（更灵活，支持复杂操作如批量删除） - 改用 channel + 单独 goroutine 管理 map（适合需要强一致性或复杂事务逻辑）
sync.Map 的写法示例：
var m sync.Map
m.Store("key", 42)
if val, ok := m.Load("key"); ok {
fmt.Println(val)
}
map key 类型不支持比较操作
Go 要求 map 的 key 类型必须是「可比较的」（comparable），即能用 == 和 != 判断相等性。以下类型**不能作为 key**：
-
[]int、[ ]string（切片） -
map[string]int（map 本身） -
func()（函数） - 包含上述类型的 struct（哪怕只嵌套一层）
编译时就会报错：invalid map key type XXX。例如：
// ❌ 编译失败
m := make(map[[]int]string)
// ✅ 改用 string 表示 slice（如 strings.Join）或自定义可比较结构体
type Key struct {
A, B int
}
m := make(map[Key]string)
注意：数组（如 [3]int）是可比较的，可以作 key；而切片不行——这点容易混淆。
初始化容量设置过大或为负数
make(map[K]V, n) 的第二个参数是预分配的 bucket 数量（非严格元素上限）。传入负数会 panic：make: size out of range；传入极大值（如 1）可能触发内存分配失败或 OOM。
实际使用中需注意：
- 容量参数是提示，Go 运行时会按需扩容，不设或设为 0 完全合法
- 若已知大致元素数量（如 1000 条），设为相近值（如 1024）可减少 rehash 次数，提升性能
- 不要盲目设大，尤其在内存受限环境（如 serverless 函数）中，初始 bucket 占用不可忽略
例如：
// ✅ 合理预估 m := make(map[string]*User, 1000) // ❌ 负数直接 panic m := make(map[string]int, -1) // ⚠️ 过大不一定更好，且可能掩盖真实负载问题 m := make(map[string]int, 10000000)
真正影响 map 健壮性的，往往不是容量数字本身，而是对「零值 nil map」和「并发安全边界」的误判——这两个点一旦出错，程序不是编译不过，就是 runtime 直接崩，很难靠日志定位。
