go test -run testname 可快速运行指定测试函数,支持正则匹配,但需注意大小写、导出规则、函数签名、包路径、build tags 及 windows 引号转义等问题。

只跑某个测试函数用 -run
想快速验证一个刚改的测试,又不想等全部跑完?go test -run TestName 是最直接的办法。它支持正则匹配,比如 go test -run ^TestLogin$ 能精确命中,而 go test -run Login 会连带跑 TestLoginError 和 TestAutoLogin —— 这点容易误判结果。
常见错误是漏写包路径或进错目录:必须在待测代码所在目录执行,且 TestName 是函数名,不是文件名或方法名。如果测试在子包里,得先 cd 进去,或者用 go test ./subpackage -run TestFoo。
-
-run只匹配测试函数名(func TestXXX(t *testing.T)),不识别结构体方法或普通函数 - 大小写敏感,
testlogin不会匹配TestLogin - 默认不运行被
t.Skip()跳过的用例;加-v才能看到跳过提示
排除某些测试用 -run 配合负向正则
有时候想跑「除了几个不稳定测试之外的所有」,比如跳过集成类或耗时测试。go test -run '^(?!TestLegacy|TestExternalAPI).*$' 就能实现。但注意 Go 的 regexp 包不支持 PCRE 风格的 (?!...),实际要用 go test -run '^(Test(?!Legacy|ExternalAPI).*)$' 这种绕法。
更稳妥的做法是标记跳过:在测试函数开头加 t.Skip("slow/integration"),再用 -run 正常跑其余。否则正则写错会导致零匹配,go test 默默退出、不报错也不提示——这是最容易踩的坑。
立即学习“go语言免费学习笔记(深入)”;
- 空匹配不会报错,只会显示
ok . 0.001s,容易误以为成功 - 推荐先用
go test -list .看当前包所有测试名,再构造正则 - Windows 命令行对单引号处理异常,建议改用双引号并转义美元符:
"^(Test(?!Legacy).*)$"
-count 和 -race 对单测的影响
调试竞态问题时,常加 -race;怀疑随机失败时,会加 -count=5 多跑几次。但这两者叠加可能让单个测试变慢十倍以上,尤其涉及文件 I/O 或网络调用的测试。
例如 go test -run TestCache -race -count=3 会把同一测试连续跑三遍,每遍都启动 race detector —— 内存占用飙升,还可能因时间拉长触发超时逻辑,导致本不该失败的测试挂掉。
-
-race本身会让程序变慢 2–5 倍,-count是乘性放大,不是加性 - 若测试依赖全局状态(如共享 map、临时文件),
-count下多次执行可能互相污染 - 真正需要多轮验证时,优先用
for i in {1..5}; do go test -run TestFoo; done替代-count,避免状态残留
为什么 go test -run 找不到你的测试函数
最常见原因是函数没导出或签名不对。Go 测试函数必须满足两个硬性条件:名字以 Test 开头,且参数是 *testing.T(或 *testing.B)。写成 testFoo、TestFoo(t testing.T)(少 *)、TestFoo(t *testing.T, extra string) 都会被忽略,且 go test 一声不吭。
另一个隐蔽问题是构建约束(build tags)。如果测试文件顶部有 //go:build integration,而你没加对应 tag 运行,它就根本不会被编译进来。此时 go test -list . 也看不到它。
- 检查函数签名是否为
func TestXXX(t *testing.T),注意首字母大写和指针符号 - 确认测试文件名以
_test.go结尾,且不在main包里 - 用
go test -list=. -v查看实际加载了哪些测试,比猜更可靠










