go 竞争检测器用 go run -race 或 go test -race 启用，属运行时插桩，仅覆盖实际执行路径，未触发的并发逻辑无法检测，且性能开销大，严禁生产环境使用。
Go 竞争检测器（race detector）怎么开，开了就准吗
Go 的 -race 编译标志是目前最实用的竞争检测手段，但它不是静态分析，而是运行时插桩——意味着只有实际执行到的代码路径才会被检查。没跑过的分支、冷门 goroutine、或只在压测中触发的并发逻辑，-race 会完全沉默。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 本地开发阶段就加
go run -race main.go或go test -race，别等上线后靠日志猜 - 测试必须真正启动 goroutine 并发读写共享变量，比如用
sync.WaitGroup控制并发数，不能只“声明”goroutine 就结束 -
-race会显著拖慢程序（2–5 倍），内存占用翻倍，**切勿在生产环境开启**；它也不是性能剖析工具，别拿它压测 - 检测到的报告里，
Previous write at和Current read at行号才是关键，顺着看哪两个 goroutine 在碰同一块内存
什么时候该用 sync.Mutex，而不是 sync.RWMutex
RWMutex 不是“更高级的 Mutex”，它是为「读多写少 + 读操作不修改状态」场景设计的。一旦写操作频繁，或读操作本身带副作用（比如缓存更新、日志打点），RWMutex 反而比 Mutex 更重——它的读锁需要原子计数、写锁要等所有读锁释放，锁升级（读→写）更是死锁高发区。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 如果写操作占比超过 10%，或单次读操作耗时 >100µs（比如含网络调用、JSON 解析），直接用
Mutex更稳 -
RWMutex.RLock()后忘记RUnlock()是常见 panic 来源，尤其在 error 分支或 defer 中混用时；Mutex的 lock/unlock 对称性更强，容错率略高 - 不要为了“看起来更细粒度”而拆分字段级
RWMutex，比如给 struct 每个字段配一个RWMutex——这会放大 cache line 伪共享，反而降低吞吐
sync.Mutex 忘记 unlock 的典型表现和定位方法
忘记调用 Unlock() 不会立刻 panic，而是让后续所有 Lock() 卡死在 goroutine 等待队列里。现象通常是：程序 CPU 低、goroutine 数持续上涨、HTTP 接口超时增多，但日志里没有明显错误。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
pprof/goroutine查看阻塞堆栈：curl 'http://localhost:6060/debug/pprof/goroutine?debug=2'，搜sync.runtime_SemacquireMutex，看哪些函数卡在Lock() - 所有
Lock()必须配对defer mu.Unlock()，且defer要紧贴Lock()下一行，避免中间有 return 或 panic 绕过 - 考虑用封装类型替代裸
Mutex，例如：type guardedValue struct { mu sync.Mutex; v int }，把读写逻辑收进方法里，减少裸锁暴露面
map 并发读写 panic 为什么不能靠 RWMutex 完全解决
Go 的原生 map 本身不是线程安全的，即使只读，多个 goroutine 同时遍历（range）也可能触发 fatal error: concurrent map iteration and map write。这是因为 map 底层哈希表扩容时会移动 bucket，迭代器指针可能悬空。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
RWMutex只能保“读操作不改 map 结构”，但无法阻止 map 自身扩容导致的迭代崩溃；只要存在任何写操作（哪怕极少），所有读都必须加锁 - 高频读写场景优先换
sync.Map，但它不适合存大对象（会逃逸）、不支持遍历一致性保证，且零值初始化后不能直接传指针赋值 - 若业务允许最终一致性，可考虑用读写双 buffer + 原子指针切换（
atomic.StorePointer），避免锁竞争，但需自行管理内存生命周期
锁的本质是协调，不是魔法。竞争检测能告诉你“哪里坏了”，但消除竞争得靠你理解数据流和控制流——尤其是那些没出现在 stack trace 里的隐式共享。
