Go测试文件必须以_test.go结尾且与被测代码同包;测试函数须为func TestXxx(testing.T)签名;go test支持多种运行方式;testing.T非并发安全,需谨慎使用。

Go 测试文件必须以 _test.go 结尾
Go 的 go test 命令只会自动识别和运行后缀为 _test.go 的文件。如果命名为 utils_test.go,它会被识别;但写成 test_utils.go 或 utils_test.go.bak 就完全不会执行。
- 测试文件需与被测代码在同一包内(通常同目录),才能直接访问未导出的函数和变量
- 若想测试私有逻辑,不要把测试文件放到新包里——否则无法调用
unexportedFunc() - 跨包测试(如集成测试)应新建独立包,用
import引入目标包,只测导出项
func TestXxx(*testing.T) 是唯一被识别的测试函数签名
Go 不支持自定义测试函数名或参数类型。只有形如 func TestSomething(t *testing.T) 的函数才会被 go test 扫描到。常见错误包括:
- 写成
func testSomething(t *testing.T)(首字母小写 → 忽略) - 漏掉
*testing.T参数,或改成*testing.B(那是基准测试,不是单元测试) - 多加一个参数,比如
func TestXxx(t *testing.T, ctx context.Context)(编译通过但不被识别)
func TestAdd(t *testing.T) {
got := Add(2, 3)
want := 5
if got != want {
t.Errorf("Add(2,3) = %d, want %d", got, want)
}
}使用 go test 运行时要注意工作目录和包路径
在模块根目录下执行 go test 默认跑当前包;加 -v 可看详细输出,加 -run 可匹配测试函数名。
-
go test:仅运行当前目录下的*_test.go -
go test ./...:递归运行所有子目录中的测试(推荐 CI 场景) -
go test -run=^TestAdd$:精确匹配函数名(^和$是正则锚点) - 若项目启用了 Go modules,确保
go.mod存在且GO111MODULE=on(默认已启用)
别忘了 testing.T 的并发安全限制
*testing.T 对象不是并发安全的——不能在 goroutine 中直接调用 t.Log 或 t.Error,否则可能 panic 或输出错乱。
立即学习“go语言免费学习笔记(深入)”;
- 需要并发验证时,先收集结果,主 goroutine 再断言
- 用
t.Parallel()标记测试可并行执行,但前提是测试间无共享状态 -
t.Fatal/t.Fatalf会终止当前测试函数,但不影响其他测试;而os.Exit(1)会直接退出整个go test进程,禁止使用
func TestConcurrentAdd(t *testing.T) {
t.Parallel() // 允许与其他 Parallel 测试并发运行
results := make(chan int, 10)
for i := 0; i < 10; i++ {
go func() {
results <- Add(1, 1)
}()
}
for i := 0; i < 10; i++ {
if got := <-results; got != 2 {
t.Errorf("expected 2, got %d", got) // 在主 goroutine 中调用
}
}
}真正容易被忽略的是:测试文件里 import 的包,只要没被任何测试函数实际引用,Go 编译器会静默忽略——这意味着 _test.go 中写了 import "net/http" 却没用,不会报错,但后续加了 http 相关逻辑却忘记补 import,就会编译失败。检查方式很简单:go test -v -x 看实际执行的编译命令,或用 go list -f '{{.Imports}}' xxx_test.go 确认依赖是否完整。










