go test 默认只运行当前目录下同包的*_test.go文件,因Go要求测试与被测代码同包、文件名匹配、函数名符合TestXXX规范且公有。
执行 go test 时,它默认只查找并运行当前目录下的 *_test.go 文件,且仅限于当前包(即 package xxx 与当前目录名一致)。不会递归子目录,也不会自动加载其他包的测试代码。
常见误操作是把测试文件放在 tests/ 子目录下,结果 go test 完全没反应——因为那个目录里没有 package main 或对应包声明,Go 直接跳过。
./,且都声明 package mylib)_test.go 结尾,否则不被识别func TestXXX(t *testing.T),且位于同一包中-run 接收正则表达式,匹配测试函数名。它不是模糊搜索,而是严格按 Go 的 regexp 规则匹配,且默认锚定在函数名开头。
比如有函数 TestParseURL 和 TestParseURLEscape:
go test -run ^TestParseURL$
这样只会跑 TestParseURL;而写成 -run ParseURL 会同时命中两个(因为子串匹配)。
^ 和 $ 显式限定边界,避免意外连带在测试函数中用 log.Printf 打印的内容,默认不会出现在 go test -v 输出里。这是因为 log 包输出到标准错误(stderr),而 go test 会捕获测试期间的 stdout/stderr,但仅当测试失败或使用 -v 时才将它们与测试日志合并显示——前提是这些输出发生在 t.Log 或 t.Logf 调用中。
t.Log("msg") 或 t.Logf("val=%v", x),它们会在 -v 下清晰标注所属测试log.Printf,需加 -v 且确保测试未提前失败(失败后 stderr 可能被截断)
-v 才显示;而 t.Error 类函数总会输出go test 默认不会重新编译被测包以外的依赖,除非源码有变更。但如果你修改了 internal/ 下的模块或 vendor 内容,可能需要强制刷新缓存。
覆盖率统计则依赖 -cover 系列参数:
go test -cover -covermode=count -coverprofile=coverage.out
其中 -covermode=count 记录每行执行次数,比默认的 set(仅是否执行)更有价值;coverage.out 是二进制格式,需用 go tool cover 查看:
go tool cover -html=coverage.out -o coverage.html
go test 加载的包,跨 module 的依赖不会自动纳入-tags 或 -gcflags
go test ./... -covermode=count -coverprofile=coverage.txt 跑全量,但要注意 ./... 会跳过 vendor 和隐藏目录TestMain 里初始化全局状态,却忘了在每个测试前重置,导致测试间相互污染。这类问题不会报错,但会让测试结果不可靠。