Go / 系统课时
用 testing 写单元测试
用 testing 写单元测试
单元测试最适合验证输入与输出明确的小函数。本篇会建立最小 Go 模块,用 _test.go、TestXxx、t.Run 和失败报告测试名称归一化函数,并用 go test 验证测试发现与执行规则。
学习目标
- 能创建符合 Go 约定的
_test.go文件和TestXxx测试函数。 - 会用
t.Run组织子测试,并用t.Fatalf输出可定位的got/want差异。 - 能用
go test、-run与-v选择并观察测试执行结果。
建立可测试的最小包
创建目录后初始化模块,模块名可以是本地示例用的 example.com/testing-demo。测试文件与被测文件放在同一个包时,可以直接访问包内未导出的标识符;本篇只测试导出的 NormalizeName。
mkdir testing-demo
cd testing-demo
go mod init example.com/testing-demo预期输出:
go: creating new go.mod: module example.com/testing-demo新建 name.go,让函数完成两件事:去掉首尾空白,并统一转成小写。这个函数没有网络、文件或时间依赖,适合做快速单元测试。
package testingdemo
import "strings"
func NormalizeName(s string) string {
return strings.ToLower(strings.TrimSpace(s))
}预期结果:保存后执行 go test 时,Go 能编译该包;函数输入 " Alice " 时应返回 "alice"。
用 TestXxx 和 t.Run 写断言
Go 的 testing 包按命名约定发现测试:函数必须以 Test 开头,签名必须是 func TestXxx(t *testing.T)。下面把两个场景放进一个测试函数,再用 t.Run 给每个场景独立命名。
package testingdemo
import "testing"
func TestNormalizeName(t *testing.T) {
t.Run("trim and lowercase", func(t *testing.T) {
got := NormalizeName(" Alice ")
want := "alice"
if got != want {
t.Fatalf("NormalizeName() = %q, want %q", got, want)
}
})
t.Run("empty after trim", func(t *testing.T) {
got := NormalizeName(" ")
want := ""
if got != want {
t.Fatalf("NormalizeName() = %q, want %q", got, want)
}
})
}预期结果:将代码保存为 name_test.go 后,两个子测试都应通过;若断言失败,t.Fatalf 会立即终止当前子测试并报告实际值与期望值。
运行完整包测试:
go test -v预期输出:
=== RUN TestNormalizeName
=== RUN TestNormalizeName/trim_and_lowercase
=== RUN TestNormalizeName/empty_after_trim
--- PASS: TestNormalizeName (<TIME>)
--- PASS: TestNormalizeName/trim_and_lowercase (<TIME>)
--- PASS: TestNormalizeName/empty_after_trim (<TIME>)
PASS
ok example.com/testing-demo <TIME><TIME> 由机器性能决定,实际值可能不同。子测试名称中的空格会在 go test -v 输出里显示为下划线,便于在命令行中稳定引用。
读取失败报告
故意把第一个子测试的 want 改成 "alice smith" 后再次执行 go test -v,测试会失败。失败报告最值得关注的是测试路径、断言文本和最终 FAIL 状态;行号可能因文件内容变化而不同。
go test -run 'TestNormalizeName/trim_and_lowercase' -v预期输出:
=== RUN TestNormalizeName
=== RUN TestNormalizeName/trim_and_lowercase
name_test.go:<LINE>: NormalizeName() = "alice", want "alice smith"
--- FAIL: TestNormalizeName (<TIME>)
--- FAIL: TestNormalizeName/trim_and_lowercase (<TIME>)
FAIL
exit status 1
FAIL example.com/testing-demo <TIME>这里 -run 接收正则表达式,路径可匹配父测试和子测试。定位失败时先看 NormalizeName() = "alice", want "alice smith",它直接说明实际结果与期望值的差异。
选择合适的失败 API
testing.T 常用的失败方法有明确差别。一般断言失败且后续检查已无意义时用 t.Fatalf;如果还希望继续执行当前测试中的其他独立检查,可用 t.Errorf。辅助函数里调用 t.Helper(),可以让失败位置指向调用者而不是辅助函数内部。
不要在单元测试里依赖测试执行顺序,也不要让多个测试共享可变全局状态。保持测试独立后,go test ./... 才能稳定地作为本地检查和持续集成入口。