Go / 系统课时

运行与筛选测试

运行与筛选测试

面对一个包含多个包和大量测试函数的 Go 项目,最有效的做法不是反复全量执行,而是先确定包范围,再用名称过滤锁定目标用例,并结合详细输出与重复执行确认结果是否稳定。本节给出一条可复用的 go test 筛选路径。

学习目标

  • 能用包参数控制 go test 的执行范围
  • 能用 -run、-v 和 -count 精确筛选并观察测试
  • 能根据输出确认实际执行了哪些用例以及重复次数

准备一个可筛选的测试文件

在任意已有 go.mod 的 Go 包目录中创建 calc_test.go。下面的测试包含两个目标用例和一个不应被本次筛选命中的用例,便于观察 -run 的效果。

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

预期结果

text
保存 calc_test.go 本身不会产生终端输出;执行下方 go test 命令后验证筛选结果。

三个测试都能通过,因此后续输出差异只来自包范围、名称筛选和重复次数,而不是断言失败。

用一条命令组合筛选条件

go test 后面的包模式先决定“在哪些包里找测试”。. 表示当前包,./... 表示当前模块目录及其所有子包,./pkg/... 则只覆盖指定目录树。项目结构不确定时,通常先从较小范围开始,再逐步扩大。

本例执行整个模块,但只运行名称匹配 TestAdd 或 TestSubtract 的测试,并打开详细输出、连续执行两轮:

bash
go test ./... -run '^Test(Add|Subtract)$' -v -count=2

预期输出

text
=== 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 即可。

建立稳定的筛选顺序

实际排查时,可以固定使用“包范围 → 测试名 → 详细输出 → 重复次数”的顺序。先减少候选包,再减少候选测试,最后才增加输出和重复执行成本。这样既能避免全量测试带来的噪声,也能清楚证明某个用例是否被执行、执行了几次以及结果是否稳定。

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

目录与阅读设置

记录一个想法

运行与筛选测试

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

登录哪都通