Go测试函数必须命名为Test且参数为testing.T,需置于*_test.go文件中、同包内,子测试名禁用斜杠和空格,测试文件应保持纯净以避免意外依赖。

Go 测试函数必须叫 Test*,且参数只能是 *testing.T
Go 的测试框架靠函数名和签名识别测试用例,不是靠注解或配置。如果你写了个函数叫 checkLogin 或 TestLogin 但参数是 int,go test 根本不会执行它。
-
func TestXxx(t *testing.T)是唯一被识别为测试的格式,Xxx必须大写字母开头(否则包外不可见,测试也无法导入) - 不能是
func TestXxx(t *testing.B)—— 那是基准测试,要用go test -bench - 不能漏掉
*testing.T参数,哪怕你什么都没调用;少一个星号(testing.T)也会编译失败 - 函数必须放在
_test.go文件里,且文件名要匹配(如user_test.go对应user.go)
为什么 go test 找不到你的 TestXxx 函数
常见原因是包作用域或构建约束没对上。Go 不会跨包运行测试,也不会加载被 // +build 排除的文件。
- 确认测试函数和被测代码在同一个包(比如都是
package user),别误写成package user_test(那是黑盒测试专用,且需显式导入原包) - 检查文件名是否含
_test.go,且没有拼错(user.test.go或user_test.g0都无效) - 如果用了构建标签(如
// +build integration),记得加-tags=integration才能运行 - 运行时用
go test -v ./...看完整路径输出,确认目标包确实被扫描到了
t.Run() 嵌套子测试时,名字不能含斜杠或空格
子测试名会出现在 go test -v 输出里,也用于 -run 过滤。非法字符会导致跳过或 panic。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 正确:
t.Run("valid_email", ...)、t.Run("empty_input", ...) - 错误:
t.Run("user/email", ...)(斜杠被解释为子测试层级,但顶层函数名不含斜杠,会报invalid test name) - 错误:
t.Run("email with space", ...)(空格会让-run "email with space"解析失败) - 子测试名不参与 Go 的标识符校验,所以可以是纯数字或下划线开头,但为了可读性和过滤方便,建议只用小写字母、数字、下划线
测试文件里混写业务逻辑会破坏隔离性
很多人图省事,在 xxx_test.go 里定义辅助结构体或工具函数,结果发现主包测试失败后,这些代码还悄悄影响了其他包的构建或测试行为。
立即学习“go语言免费学习笔记(深入)”;
- 所有非
Test*函数、变量、类型,只要没加//go:build ignore,都会被编译进测试二进制,可能触发意外初始化(比如 init() 里的全局 HTTP client) - 如果必须复用逻辑,优先用
internal/testutil包,而不是直接塞进_test.go - 特别注意:不要在测试文件里 import 主包以外的、本不该被测试依赖的模块(比如把
database/sql导入到单元测试里又没 mock,容易让 CI 因环境缺失失败)

















