Golang新手最容易忽略的测试细节

P粉602998670 2026-01-07 00:00:00 次阅读

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 结束就让测试函数返回，导致竞态根本没机会触发。

必须用 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 很可能看不到问题
}