Go / 系统课时
认识 Go 测试体系
认识 Go 测试体系
Go 的测试能力不是三套彼此独立的工具,而是统一在 go test 下的三类入口:测试函数验证正确性,基准函数度量性能,模糊测试函数主动探索边界输入。本节用一个最小包把三者放在同一工作流里,观察它们何时执行、各自回答什么问题。
学习目标
- 区分
TestXxx、BenchmarkXxx与FuzzXxx的职责和函数签名。 - 理解
go test如何发现测试文件,并在普通、基准和模糊模式下选择不同入口。 - 能用最小示例验证正确性、性能基线和输入鲁棒性。
三类入口回答不同问题
Go 只会把以 _test.go 结尾的文件作为测试源码交给测试工具链。三类入口都位于这些文件中,但它们关注的信号不同:测试函数判断结果是否正确;基准函数重复执行目标代码并报告耗时等指标;模糊测试函数从种子输入出发生成变体,寻找崩溃、断言失败和其他异常行为。
| 入口 | 典型签名 | 主要问题 | 常见触发方式 |
|---|---|---|---|
| 测试 | func TestXxx(t *testing.T) |
功能是否正确 | go test |
| 基准 | func BenchmarkXxx(b *testing.B) |
操作有多快、分配多少 | go test -bench ... |
| 模糊测试 | func FuzzXxx(f *testing.F) |
哪些输入会击穿假设 | go test -fuzz ... |
普通 go test 会运行测试函数,也会把 FuzzXxx 中通过 f.Add 注册的种子语料当作回归用例执行;基准函数默认不会运行。只有显式进入基准或 fuzz 模式时,工具链才会持续执行相应入口。

用一个最小包观察执行差异
片段示例:下面三个文件必须放在同一目录共同运行,单个文件不作为独立程序执行。reverse.go 提供待测函数,reverse_test.go 同时定义三类测试入口。
go.mod:
module example/testingdemo
go 1.20reverse.go:
package testingdemo
func reverseBytes(in []byte) []byte {
out := append([]byte(nil), in...)
for left, right := 0, len(out)-1; left < right; left, right = left+1, right-1 {
out[left], out[right] = out[right], out[left]
}
return out
}reverse_test.go:
package testingdemo
import (
"bytes"
"testing"
)
func TestReverse(t *testing.T) {
got := reverseBytes([]byte("go"))
if string(got) != "og" {
t.Fatalf("got %q, want %q", got, "og")
}
}
func BenchmarkReverse(b *testing.B) {
input := []byte("benchmark")
for i := 0; i < b.N; i++ {
reverseBytes(input)
}
}
func FuzzReverse(f *testing.F) {
f.Add([]byte("go"))
f.Add([]byte{})
f.Fuzz(func(t *testing.T, in []byte) {
got := reverseBytes(reverseBytes(in))
if !bytes.Equal(got, in) {
t.Fatalf("double reverse changed input: %q -> %q", in, got)
}
})
}先运行普通测试:
go test -v预期输出中会看到普通测试与 fuzz 种子语料通过;耗时会因机器不同而变化:
=== RUN TestReverse
--- PASS: TestReverse (<TIME>s)
=== RUN FuzzReverse
=== RUN FuzzReverse/seed#0
=== RUN FuzzReverse/seed#1
--- PASS: FuzzReverse (<TIME>s)
--- PASS: FuzzReverse/seed#0 (<TIME>s)
--- PASS: FuzzReverse/seed#1 (<TIME>s)
PASS
ok example/testingdemo <TIME>s基准与模糊模式需要显式选择
基准函数必须通过 -bench 选择。下面只执行 BenchmarkReverse,并用 -run '^$' 避免同时运行普通测试:
go test -run '^$' -bench '^BenchmarkReverse$'预期输出会包含每次操作的耗时;操作次数、CPU 后缀和纳秒数都是动态值:
goos: <OS>
goarch: <ARCH>
pkg: example/testingdemo
cpu: <CPU>
BenchmarkReverse-<CPU_COUNT> <ITERATIONS> <NS_PER_OP> ns/op
PASS
ok example/testingdemo <TIME>s进入真正的模糊测试时使用 go test -fuzz=FuzzReverse。此时工具链会持续生成输入并调用 FuzzReverse 中注册的目标函数;发现失败后会记录能稳定复现问题的输入,后续普通 go test 也会把它当作回归用例。
把三类信号放进同一工作流
正确性测试适合高频运行,通常应成为本地开发和 CI 的基础门禁;基准测试更适合在性能敏感代码、优化前后或专门性能任务中运行,因为结果会受硬件和系统负载影响;模糊测试适合解析器、协议处理、编码解码和边界条件复杂的纯函数。
三类入口最终都服务于同一个目标:让 go test 不只回答“能不能工作”,还逐步覆盖“工作得多稳定”和“遇到未知输入会不会失效”。