必须用go test -race检测竞态，GoLand直接运行main函数或未配置-race的测试均无效；测试文件需以_test.go结尾、函数名以Test开头；Run Configuration须手动添加race -count=1参数并启用CGO（若涉及）；测试中必须用sync.WaitGroup等显式同步goroutine。
GoLand里必须用go test -race，不能Run main函数
普通点击绿色三角运行 main 函数，哪怕加了 -race 参数，也**不会触发真实并发调度**，sync.Mutex、map 并发写等竞态问题大概率不暴露。GoLand 的 Run 配置本质是单次启动程序，没有测试生命周期管理，testing.T 上下文、goroutine 生命周期控制全失效。
真正起作用的只有 go test -race 启动的测试流程——它会构造可控 goroutine 调度、注入检测桩、等待所有并发操作完成后再判断结果。
- 测试文件名必须以
_test.go结尾（如counter_test.go） - 测试函数必须是
func TestXXX(t *testing.T)格式 - 别在 GoLand 里右键
main函数选 “Run”，那只是go run，不是测试
手动配置Run Configuration加-race参数
GoLand 默认的 test 运行配置不启用竞态检测，必须手动修改。否则右键“Run ‘TestXXX’”实际执行的是无 -race 的普通测试，等于白测。
操作路径：Run → Edit Configurations… → 选中你的 test 配置 → Program arguments 栏填入：
race -count=1
-count=1 很关键：防止 GoLand 缓存测试结果，跳过竞态路径；不要加 -v 或 -run，它们会覆盖 GoLand 自动注入的测试目标名，导致找不到函数。
- 如果项目启用了 Go Modules，确认
GOROOT和GOBIN没被错误覆盖，否则报cannot enable -race mode - 若项目含 CGO 代码，需额外设置环境变量：
CGO_ENABLED=1（否则-race会拒绝工作） - 配置保存后，右键测试函数 → “Run ‘TestXXX’” 才真正跑带竞态检测的测试
测试代码里必须用sync.WaitGroup等显式同步
竞态检测器只在内存访问层面插桩，但它**不会帮你等 goroutine 结束**。没等完就退出，-race 可能根本没机会捕获冲突。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
错误写法：time.Sleep(10 * time.Millisecond) —— 不可靠，低负载下调度延迟大，竞态窗口直接错过。
正确做法：用 sync.WaitGroup 精确控制生命周期，例如：
var wg sync.WaitGroup
for i := 0; i < 100; i++ {
wg.Add(1)
go func() {
defer wg.Done()
counter++ // 触发竞态的非原子操作
}()
}
wg.Wait() // 必须等完再返回- 别在 goroutine 里调用
t.Fatal，它只终止当前 goroutine，主测试已结束 - 收集错误用
chan error或atomic.Value，最后统一断言 - 并发数建议 ≥100，小数量（如 2–5）太容易因调度巧合“侥幸通过”
看到 WARNING: DATA RACE 别只修 panic 行号
fatal error: concurrent map writes 是结果，不是原因。WARNING: DATA RACE 输出里的内存地址（如 0x00c00001a240）和两段调用栈才是关键证据。
重点比对两个 stack trace 中的地址是否一致——这是确认同一块内存被并发访问的铁证。常出现的情况是：
- 报错显示在
service.go:42的读操作，但真正漏锁的写操作在cache.go:87 - 闭包捕获循环变量：
for i := range items { go func() { use(i) }() }，i是共享地址，-race会报，但你得意识到问题出在变量捕获方式，不是use()本身 - 修复后仍报 race？说明锁对象不是同一个实例，或某条分支路径（如 error return 前）漏掉了
mu.Unlock()
最易忽略的一点：竞态检测依赖实际执行路径。如果测试里提前 return 或 panic，那段代码根本没运行，-race 就看不到——你以为修好了，其实只是没测到。
