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 模式时,工具链才会持续执行相应入口。

Go 测试入口与 go test 的协作关系

用一个最小包观察执行差异

片段示例:下面三个文件必须放在同一目录共同运行,单个文件不作为独立程序执行。reverse.go 提供待测函数,reverse_test.go 同时定义三类测试入口。

go.mod:

text
module example/testingdemo

go 1.20

reverse.go:

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:

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)
		}
	})
}

先运行普通测试:

bash
go test -v

预期输出中会看到普通测试与 fuzz 种子语料通过;耗时会因机器不同而变化:

text
=== 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 '^$' 避免同时运行普通测试:

bash
go test -run '^$' -bench '^BenchmarkReverse$'

预期输出会包含每次操作的耗时;操作次数、CPU 后缀和纳秒数都是动态值:

text
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 不只回答“能不能工作”,还逐步覆盖“工作得多稳定”和“遇到未知输入会不会失效”。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

认识 Go 测试体系

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通