最稳妥方式是进入模块根目录(含go.mod)后执行go test ./pkg/util,需确保该目录下有非测试的.go文件且无构建约束冲突,否则会报no go files。

go test 怎么只跑某个包
直接在对应包目录下执行 go test 最稳妥。Golang 不靠“路径通配符”匹配包,而是靠当前工作目录和 go.mod 的模块根路径共同决定“哪个包”。你以为写 go test ./pkg/util 就能跑那个包?不一定——如果当前不在模块根目录,或 ./pkg/util 根本没被 go list 识别为有效包(比如没 util.go 或全是测试文件),就会报 no Go files in 或 cannot find module。
- 进到模块根目录(含
go.mod的那层)再操作 - 确认目标路径下至少有一个非测试的
.go文件(比如helper.go),否则go test会跳过 - 用
go list -f '{{.Dir}}' ./pkg/util先验证路径是否被识别为包,输出为空就说明不合法
go test ./... 和 ./pkg/ 的区别在哪
./... 是递归匹配所有子目录下的包,但只包括“有 Go 源码的目录”;./pkg/ 是精确匹配 pkg 这一层的子目录(不含更深层)。两者行为差异常导致误判:比如你执行 go test ./pkg/,它只会跑 pkg 目录下的包(如 pkg/a、pkg/b),但不会进 pkg/util/string;而 go test ./pkg/... 才会进到所有嵌套层级。
-
./pkg/:等价于go list ./pkg/...中一级子目录的包集合 -
./pkg/...:等价于go list ./pkg/...全部匹配结果,深度不限 - 如果
pkg下没有直接的 Go 文件(只有子目录),./pkg/会提示no Go files,但./pkg/...可能正常运行子包
怎么排除某个子包不跑测试
Go 原生不支持 --exclude 这类参数,得靠 shell 组合或临时重命名。最常用的是用 go list 筛出要测的包,再交给 go test:
go list ./pkg/... | grep -v '/mock$' | xargs go test
注意这里 grep -v '/mock$' 是按包导入路径匹配(不是文件系统路径),所以得确保 mock 包的路径以 /mock 结尾。另外,Windows 上别用 xargs,改用 for /f 或 PowerShell 的 ForEach-Object。
立即学习“go语言免费学习笔记(深入)”;
- 避免用
rm -rf pkg/mock临时删包——容易误删、影响 IDE 索引、且 git status 变脏 - 不要依赖
// +build ignore:它只影响构建,不影响go test扫描包 - 如果只是跳过某些测试函数,用
-run更准,比如go test -run '^TestHTTP.*'
为什么 go test ./pkg/util 报错 no buildable Go source files
这个错误不是路径写错了,而是该目录下所有 .go 文件都带了构建约束(build tags),比如开头有 // +build integration,而你没加 -tags integration。或者文件全是 *_test.go,但没配 -run 指定测试函数,go test 默认只编译非测试文件来构建包。
- 运行
go list -f '{{.GoFiles}} {{.TestGoFiles}}' ./pkg/util查看哪些文件被识别 - 如果
.GoFiles是空列表,检查是否有// +build行,以及当前是否传了对应-tags - 如果只想跑测试文件本身(无非测试源码),用
go test ./pkg/util -run .强制触发,但前提是该目录被识别为包(即有package util且至少一个.go文件满足构建条件)
真正麻烦的是混合了多个构建约束的项目,比如同时有 // +build !windows,!darwin 和 // +build unit 的文件——这时候必须显式指定完整 tag 组合,漏一个就全盘失效。










