最简Go单元测试需满足三要素：文件名以_test.go结尾、函数名以Test开头、参数为*testing.T；示例中TestAdd调用Add(2,3)并用t.Errorf校验结果是否为5。
怎么写一个最简可用的 Go 单元测试
Go 的 testing 包不需要额外安装，只要文件名以 _test.go 结尾、函数名以 Test 开头、参数为 *testing.T，就能被 go test 自动识别。
常见错误：把测试函数写成 func testAdd() {}（没带 *testing.T）或 func TestAdd(t *testing.T) error {}（返回值非 void），都会导致测试不运行或编译失败。
示例：
package calc
import "testing"
func TestAdd(t *testing.T) {
result := Add(2, 3)
if result != 5 {
t.Errorf("expected 5, got %d", result)
}
}
如何用 t.Run 组织多个子测试用例
单个 Test* 函数里用 t.Run 可以跑多个逻辑相近但输入不同的测试，失败时能精准定位到具体子项，还能共享 setup/teardown 逻辑。
容易踩的坑：在循环中直接用循环变量做子测试名或传参，比如：
立即学习“go语言免费学习笔记（深入）”；
for _, tc := range cases { t.Run(tc.name, func(t *testing.T) { ... }) } —— 如果 tc 是指针或闭包捕获了循环变量，所有子测试可能共用最后一个 tc 值。
正确做法是用局部变量绑定：
for _, tc := range cases {
tc := tc // 显式复制
t.Run(tc.name, func(t *testing.T) {
got := Add(tc.a, tc.b)
if got != tc.want {
t.Errorf("Add(%d,%d) = %d, want %d", tc.a, tc.b, got, tc.want)
}
})
}
怎样测 panic、error 和并发行为
Go 测试不能靠 try/catch 捕获 panic，必须用 func(){}() 匿名函数 + recover() 手动拦截；t.Fatal 会终止当前测试，t.Error 则继续执行后续断言。
- 测 panic：
func TestDividePanic(t *testing.T) { defer func() { if r := recover(); r == nil { t.Error("expected panic but didn't happen") } }() Divide(1, 0) // 假设这个函数会 panic } - 测 error 返回：直接检查返回的
error是否为nil或是否包含预期字符串，避免用fmt.Sprintf("%v", err)做模糊匹配，应优先用errors.Is或errors.As。 - 测 goroutine 行为：用
sync.WaitGroup或time.Sleep（不推荐）确保协程结束；更稳妥的是用chan struct{}通知完成，或借助testify/assert等库的超时机制。
为什么 go test -race 要在 CI 中默认开启
Go 的竞态检测器（-race）会在运行时插桩，发现数据竞争——比如两个 goroutine 同时读写同一个变量且无同步。它不改变程序逻辑，但会显著降低性能（约 2–5 倍），所以只应在测试阶段启用。
关键点：go test -race 要求所有依赖包（包括标准库）也用 race 模式构建，因此不能只对某个文件单独开；若项目用了 cgo，需确认 C 代码本身线程安全。
CI 中漏掉 -race，很可能让一个只在高并发下偶发崩溃的 bug 长期潜伏——而这种 bug 在本地几乎无法复现。
