Go测试文件名须以_test.go结尾且与源文件同目录，Test函数需严格满足func TestXxx(t *testing.T)签名，并行测试须首行调用t.Parallel()并避免共享状态，-race需配合同步机制才有效。
测试文件名必须以 _test.go 结尾
Go 的 go test 命令只识别以 _test.go 结尾的文件。写完测试却始终不运行？大概率是文件名写成了 user_test.go.bak、test_user.go，或者直接忘了加下划线和后缀。
-
user_test.go✅ 正确 -
user_test.go~❌ 会被忽略（编辑器临时文件） -
user_test.go.txt❌ 即使内容正确也无效 -
user_test.go和user.go必须在同一包目录下（不能跨目录引用）
Test 函数签名必须严格匹配 func TestXxx(t *testing.T)
函数名必须以 Test 开头，且首字母大写；参数有且仅有一个 *testing.T 类型；返回值不能有任何声明。少一个星号、多一个 error、函数名写成 testXxx 或 TESTXxx，都会被 go test 完全跳过。
func TestValidateEmail(t *testing.T) { // ✅ 正确
if !isValid("a@b.c") {
t.Error("expected true, got false")
}
}
func testValidateEmail(t *testing.T) { } // ❌ 小写开头，不运行
func TestValidateEmail(t testing.T) { } // ❌ 缺少 *，编译失败
func TestValidateEmail(t *testing.T) bool { } // ❌ 多了返回值，编译失败
并发测试中忘记调用 t.Parallel() 或误用 defer
多个 TestXxx 函数默认串行执行。想并行跑？必须显式调用 t.Parallel() —— 而且它得放在函数最开头，否则可能因状态污染导致随机失败。
-
t.Parallel()必须在任何t.Log/t.Error之前调用 - 不要在
defer里调用它（defer t.Parallel()无效且无提示） - 并行测试间不能共享可变状态（如全局 map、未加锁的 struct 字段）
- 若测试依赖外部服务（如数据库连接），并行可能触发连接池耗尽或竞态，此时应禁用并行或用
-p 1
使用 go test -race 但没覆盖实际并发路径
Go 的竞态检测器（-race）只对实际执行到的代码起作用。新手常犯的错误是：写了 go doWork()，却没等 goroutine 结束就让测试函数返回，导致竞态根本没机会触发。
立即学习“go语言免费学习笔记（深入）”；
- 必须用
sync.WaitGroup或channel确保所有 goroutine 完成 -
time.Sleep不可靠，不能替代同步机制 -
-race本身会显著拖慢测试速度，建议只在 CI 或本地排查时启用，而非日常go test
func TestConcurrentMapAccess(t *testing.T) {
m := make(map[string]int)
var wg sync.WaitGroup
for i := 0; i < 10; i++ {
wg.Add(1)
go func(i int) {
defer wg.Done()
m[fmt.Sprintf("key%d", i)] = i // 可能触发 race
}(i)
}
wg.Wait() // ⚠️ 没这句，-race 很可能看不到问题
}
真正容易漏掉的，是测试文件命名和函数签名这种“硬规则”——它们不报错、不警告，只是静默跳过。一旦怀疑测试没跑，先盯住这两个地方。 
