Go / 系统课时
运行与筛选测试
运行与筛选测试
面对一个包含多个包和大量测试函数的 Go 项目,最有效的做法不是反复全量执行,而是先确定包范围,再用名称过滤锁定目标用例,并结合详细输出与重复执行确认结果是否稳定。本节给出一条可复用的 go test 筛选路径。
学习目标
- 能用包参数控制
go test的执行范围 - 能用
-run、-v和-count精确筛选并观察测试 - 能根据输出确认实际执行了哪些用例以及重复次数
准备一个可筛选的测试文件
在任意已有 go.mod 的 Go 包目录中创建 calc_test.go。下面的测试包含两个目标用例和一个不应被本次筛选命中的用例,便于观察 -run 的效果。
package testingdemo
import "testing"
func TestAdd(t *testing.T) {
if got := 2 + 3; got != 5 {
t.Fatalf("want 5, got %d", got)
}
}
func TestSubtract(t *testing.T) {
if got := 7 - 2; got != 5 {
t.Fatalf("want 5, got %d", got)
}
}
func TestMultiply(t *testing.T) {
if got := 3 * 4; got != 12 {
t.Fatalf("want 12, got %d", got)
}
}预期结果
保存 calc_test.go 本身不会产生终端输出;执行下方 go test 命令后验证筛选结果。三个测试都能通过,因此后续输出差异只来自包范围、名称筛选和重复次数,而不是断言失败。
用一条命令组合筛选条件
go test 后面的包模式先决定“在哪些包里找测试”。. 表示当前包,./... 表示当前模块目录及其所有子包,./pkg/... 则只覆盖指定目录树。项目结构不确定时,通常先从较小范围开始,再逐步扩大。
本例执行整个模块,但只运行名称匹配 TestAdd 或 TestSubtract 的测试,并打开详细输出、连续执行两轮:
go test ./... -run '^Test(Add|Subtract)$' -v -count=2预期输出
=== RUN TestAdd
--- PASS: TestAdd (<TIME>s)
=== RUN TestSubtract
--- PASS: TestSubtract (<TIME>s)
=== RUN TestAdd
--- PASS: TestAdd (<TIME>s)
=== RUN TestSubtract
--- PASS: TestSubtract (<TIME>s)
PASS
ok <MODULE_PATH> <TIME>s<MODULE_PATH> 是实际模块包路径,<TIME> 会随机器与 Go 版本变化。输出中没有 TestMultiply,说明 -run 的正则只命中了两个目标测试;每个目标出现两次,则说明 -count=2 已生效。
读懂几个关键参数
-run 接受正则表达式,而不是简单的字符串包含关系。需要精确匹配单个测试时,可使用 ^TestAdd$ 这样的正则;如果省略首尾锚点,名称中只要存在匹配片段就可能被执行。对于子测试,-run 还会按斜杠分隔的名称层级继续匹配,因此筛选失败时应先确认完整测试名。
-v 会显示每个测试的开始、通过或失败信息,也会让通过用例中的 t.Log 输出可见。只关心最终成败时可以省略,但排查“到底执行了谁”时建议打开。
-count=N 会让匹配到的测试重复执行 N 次,同时避免直接复用测试结果缓存。定位偶发失败时,可以先用较小次数复现;只想强制重新执行一次时,将 N 设为 1 即可。
建立稳定的筛选顺序
实际排查时,可以固定使用“包范围 → 测试名 → 详细输出 → 重复次数”的顺序。先减少候选包,再减少候选测试,最后才增加输出和重复执行成本。这样既能避免全量测试带来的噪声,也能清楚证明某个用例是否被执行、执行了几次以及结果是否稳定。