go单元测试简洁高效,只需_test.go文件、Test开头函数和*testing.T参数;支持table-driven批量测试、错误/panic验证及接口mock,强调快速建立代码信心。

Go 语言的单元测试非常简洁直接,不需要额外框架,只要遵循命名和目录约定,用内置的 命令就能跑起来。核心就三点:测试文件名以 go test_test.go 结尾、测试函数名以 Test 开头、函数签名必须是 func(t *testing.T)。
写一个最简单的测试函数
假设你有一个计算两个整数之和的函数:
add.go
package main func Add(a, b int) int { return a + b }
对应写测试文件(注意文件名):
立即学习“go语言免费学习笔记(深入)”;
add_test.go
package main import "testing" func TestAdd(t *testing.T) { result := Add(2, 3) if result != 5 { t.Errorf("expected 5, got %d", result) } }
在项目根目录运行:
go test
看到 ok your-module-name 0.001s 就表示通过了。加 -v 参数可以看详细输出:
go test -v
用 table-driven 方式批量测多个用例
手动写一堆 if 容易重复,Go 社区推荐用结构体切片组织测试数据,更清晰也更易维护:
func TestAdd(t *testing.T) { tests := []struct { name string a, b int expected int }{ {"positive", 2, 3, 5}, {"negative", -1, -1, -2}, {"zero", 0, 0, 0}, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { result := Add(tt.a, tt.b) if result != tt.expected { t.Errorf("got %d, want %d", result, tt.expected) } }) } }
-
t.Run支持子测试,每个用例独立运行,失败时能精准定位到哪个 case - 名字字段(
name)建议有意义,比如"Add_with_negative_numbers" - 测试数据尽量覆盖边界值:正数、负数、零、溢出临界点(如
math.MaxInt64)
测试错误路径和 panic
不仅要测“正常返回”,还要验证函数在异常输入下是否按预期处理错误或 panic:
比如一个除法函数:
func Divide(a, b float64) (float64, error) { if b == 0 { return 0, errors.New("division by zero") } return a / b, nil }
测试它返回错误的情况:
func TestDivide(t *testing.T) { _, err := Divide(10, 0) if err == nil { t.Error("expected error when dividing by zero") } if !strings.Contains(err.Error(), "division by zero") { t.Error("error message mismatch") } }
如果函数应该 panic(比如断言参数非空),用 func() {...}() 包裹并配合 recover 捕获:
func TestSomethingPanic(t *testing.T) { defer func() { if r := recover(); r == nil { t.Fatal("expected panic") } }() SomethingThatShouldPanic(nil) }
测试依赖外部资源?用接口 + mock 简单替换
真实项目中常要测 http 调用、数据库操作等。Go 推崇“依赖抽象”,把具体实现抽成接口,测试时换 mock 实现即可:
type Client interface { Get(url string) ([]byte, error) } func FetchData(c Client, url string) (string, error) { data, err := c.Get(url) return string(data), err }
测试时写个假 client:
type mockClient struct { resp []byte err error } func (m mockClient) Get(_ string) ([]byte, error) { return m.resp, m.err } func TestFetchData(t *testing.T) { c := mockClient{resp: []byte("hello"), err: nil} result, err := FetchData(c, "http://example.com") if err != nil || result != "hello" { t.Error("unexpected result or error") } }
- 不强求用第三方 mock 库,简单场景自己写 mock 类型就够了
- 重点是让被测函数不绑定具体实现,测试才可控、可重复
基本上就这些。Go 的测试不是炫技,而是快速建立信心:改代码前先看测试绿不绿,加功能后补上对应测试。写得越早,后期越省心。