Golang单元测试编写与testing包使用教程

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Golang单元测试编写方法及testing包使用指南》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

最简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 逻辑。

容易踩的坑：在循环中直接用循环变量做子测试名或传参，比如：

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 在本地几乎无法复现。

本篇关于《Golang单元测试编写与testing包使用教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！