go单元测试依托testing包原生支持tdd,需先写失败测试,遵循test开头命名、xxx_test.go文件名等规范;善用t.helper()优化错误定位;推荐表驱动测试配合t.run和t.parallel;覆盖边界条件与副作用,用t.cleanup确保测试隔离。

Go 的单元测试不依赖第三方断言库,testing 包本身已提供简洁、明确的测试驱动开发(TDD)支持。关键在于理解 *testing.T 的行为逻辑、合理组织测试结构,并用原生方法实现清晰断言。
从写测试用例开始(TDD 第一步)
在 Go 中践行 TDD,第一步不是写功能代码,而是先写一个失败的测试。函数未实现时,测试会报错;函数骨架存在但逻辑未完成时,测试会因断言失败而失败——这正是你推进开发的信号。
- 测试函数名必须以
Test开头,且接受唯一参数*testing.T - 测试文件名应为
xxx_test.go,与被测源码同目录 - 用
t.Errorf()或t.Fatalf()报告失败:前者继续执行本测试,后者立即终止
例如,为待实现的加法函数写首个测试:
func TestAdd(t *testing.T) {
result := Add(2, 3)
if result != 5 {
t.Errorf("expected 5, got %d", result)
}
}
立即学习“go语言免费学习笔记(深入)”;
用 t.Helper() 标记辅助函数,让错误定位更准
当把重复的断言逻辑提取为私有函数(如 assertEqual)时,错误信息默认指向辅助函数内部行号。调用 t.Helper() 可让 t.Error/Fatal 的栈追踪“跳过”该辅助函数,直接指向调用它的测试行。
- 在辅助函数第一行添加
t.Helper() - 它不改变行为,只优化错误报告的可读性
- 不标记 helper 函数会导致调试时反复跳转,浪费时间
func assertEqual(t *testing.T, expected, actual interface{}) {
t.Helper()
if !reflect.DeepEqual(expected, actual) {
t.Errorf("expected %+v, got %+v", expected, actual)
}
}
表驱动测试:批量验证多种输入输出
Go 社区强烈推荐用结构体切片定义测试用例集,配合 range 循环执行——即“表驱动测试”。它让新增用例变得零成本,也天然支持子测试(t.Run),便于隔离和并行。
- 每个子测试用
t.Run(name, func)封装,name 建议含输入特征(如"2+3=5") - 子测试可独立失败,不影响其他用例;也可用
t.Parallel()并行加速 - 避免在循环中直接使用循环变量(如
tc)闭包捕获,应显式传参或赋值副本
tests := []struct{ a, b, want int }{
{1, 1, 2},
{0, 5, 5},
{-2, 3, 1},
}
for _, tc := range tests {
tc := tc // 防止闭包陷阱
t.Run(fmt.Sprintf("%d+%d=%d", tc.a, tc.b, tc.want), func(t *testing.T) {
t.Parallel()
if got := Add(tc.a, tc.b); got != tc.want {
t.Errorf("Add(%d,%d) = %d, want %d", tc.a, tc.b, got, tc.want)
}
})
}
测试边界与副作用:覆盖真实场景
除了主流程,单元测试需主动覆盖边界条件(空输入、负数、极大值)、错误路径(如返回 error 的函数需验证错误类型与内容),以及隐含副作用(如修改全局状态、调用外部服务)。
- 对返回
error的函数,用if err != nil检查非空,再用errors.Is()或errors.As()判断具体错误类型 - 避免在测试中真正发起网络请求或操作文件:用接口抽象依赖,测试时注入 mock 实现
- 用
t.Cleanup()注册清理函数(如关闭临时文件、重置全局变量),确保每次测试干净启动
例如测试一个可能出错的除法:
func TestDivide(t *testing.T) {
_, err := Divide(10, 0)
if !errors.Is(err, ErrDivideByZero) {
t.Errorf("expected ErrDivideByZero, got %v", err)
}
}
Go 的 testing 包设计克制而有力。它不提供花哨的断言链式调用,却通过清晰的控制流、显式的失败语义和轻量的子测试模型,支撑起稳健的 TDD 实践。写测试不是为了凑覆盖率数字,而是为了让你每次修改代码时,心里有底。










