go test 默认只运行当前目录下同包的*_test.go文件,因Go要求测试与被测代码同包、文件名匹配、函数名符合TestXXX规范且公有。

go test 默认行为为什么只跑当前包?
执行 go test 时,它默认只查找并运行当前目录下的 *_test.go 文件,且仅限于当前包(即 package xxx 与当前目录名一致)。不会递归子目录,也不会自动加载其他包的测试代码。
常见误操作是把测试文件放在 tests/ 子目录下,结果 go test 完全没反应——因为那个目录里没有 package main 或对应包声明,Go 直接跳过。
- 测试文件必须和被测代码在同一个包内(例如都在
./,且都声明package mylib) - 文件名必须以
_test.go结尾,否则不被识别 - 测试函数必须是公有函数、形如
func TestXXX(t *testing.T),且位于同一包中
如何用 -run 参数精准触发单个测试函数?
-run 接收正则表达式,匹配测试函数名。它不是模糊搜索,而是严格按 Go 的 regexp 规则匹配,且默认锚定在函数名开头。
比如有函数 TestParseURL 和 TestParseURLEscape:
立即学习“go语言免费学习笔记(深入)”;
go test -run ^TestParseURL$
这样只会跑 TestParseURL;而写成 -run ParseURL 会同时命中两个(因为子串匹配)。
- 推荐始终用
^和$显式限定边界,避免意外连带 - 大小写敏感:-run testparseurl 不会匹配任何东西
- 支持分组和转义,但简单场景下没必要复杂化
为什么 go test -v 输出里看不到 log.Printf?
在测试函数中用 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 可能被截断) - 注意:t.Log 在测试通过时默认不输出,只有
-v才显示;而t.Error类函数总会输出
如何让 go test 自动重建依赖并支持覆盖率?
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 的依赖不会自动纳入 - 如果项目含 cgo 或需要特定构建标签,记得传
-tags或-gcflags - CI 中常用
go test ./... -covermode=count -coverprofile=coverage.txt跑全量,但要注意./...会跳过 vendor 和隐藏目录
TestMain 里初始化全局状态,却忘了在每个测试前重置,导致测试间相互污染。这类问题不会报错,但会让测试结果不可靠。










