go test -race 必须紧接在 go test 后、包路径前才生效，否则静默失效；它仅在实际并发读写同一内存地址时触发，漏检是常态，不报错不等于无竞态。
go test -race 不报错，不代表没竞态；它只在真实并发读写同一内存地址时才触发——漏检是常态，不是例外。
go test -race 命令位置写错就等于没开
竞态检测器不认参数顺序，-race 必须紧跟 go test 后、包路径前，否则静默失效。
- ✅ 正确：
go test -race ./、go test -race -v mypkg、go test -race . - ❌ 错误：
go test ./ -race（-race被当成本地路径参数）、go run main.go -race（-race变成你程序的 flag） - CI 中建议统一用
go test -race ./，避免因路径写法差异漏检
测试没跑出竞态 ≠ 代码安全
go test -race 是运行时插桩，不是静态扫描。它只监控实际执行到的并发路径，以下情况它一律不报：
- 变量没逃逸：比如
for i := 0; i 中的 <code>x在栈上且未取地址，-race根本不跟踪 - 分支没覆盖：如
if debug { go writeGlobal() }，测试没开debug就完全看不见 - 竞态发生在
init()阶段：全局 map 初始化后立刻被 goroutine 写，但测试没显式 import 触发该包初始化 - 用了
sync.Map或atomic，但某个 if 分支绕过了保护逻辑
看到 DATA RACE 报告，先盯这三行
报告不是告诉你“谁先谁后”，而是指出「无同步约束下的并发访问」。关键线索只有三处：
立即学习“go语言免费学习笔记（深入）”；
-
Previous write at 0x00c00001a240 by goroutine 6→ 找到写操作所在行，比如cache.go:23的m["key"] = v -
Read at 0x00c00001a240 by goroutine 7→ 找到读操作所在行，比如cache.go:31的v := m["key"] -
created at: main.TestCacheConcurrent() cache_test.go:45→ 直接定位到启动 goroutine 的测试行，重点查闭包是否捕获了循环变量（如for _, k := range keys { go func() { get(k) }() }）
栈里出现 runtime.mapaccess1_faststr 或 runtime.mapassign_faststr，基本锁定是未加锁 map 并发读写。
修复后必须重跑 -race 验证
加了 sync.Mutex、改用 atomic.AddInt64、甚至换成 chan，都不代表问题消失。唯一验证标准是：go test -race 零警告。
- 锁没加对范围：比如只锁了写，忘了读；或锁了大段逻辑（含 HTTP 调用），导致性能崩，但读写交界处仍竞态
- 原子操作没覆盖全部路径：比如
counter用atomic.LoadInt64读，但某处直接counter++ - 结构体字段级拆锁引发伪共享：每个字段配一个
RWMutex，反而降低吞吐
真正难缠的点往往不在主逻辑，而在测试闭包捕获变量、init() 里的 goroutine、或第三方库接收了你传入的未加锁指针（比如把 *bytes.Buffer 传给多个 json.Encoder）。这些地方，-race 一报就是准的，但人容易忽略。
