Go单元测试由go test原生支持,测试函数须以Test开头、接受*testing.T参数、定义在_test.go文件中;命名需驼峰式非空后缀且首字符大写;同包测试可访问未导出成员,但需注意并发安全与清理逻辑。

Go 的单元测试不是靠框架驱动,而是由 go test 命令原生支持,所有测试函数必须以 Test 开头、接受 *testing.T 参数、且定义在 _test.go 文件中——不满足任一条件,go test 就会直接忽略。
Test 函数命名必须以 Test 开头 + 驼峰式非空后缀
Go 不允许 Test()、testFoo() 或 Test_abc() 这类写法。后缀不能是纯数字或下划线开头,也不能为空;推荐用业务语义命名,比如 TestParseURL、TestValidateEmailFormat。
-
Test后必须紧跟大写字母(Test123❌,TestHTTPClient✅) - 同文件中不能有重名的
TestXXX(哪怕参数不同也不行) - 如果想临时跳过某个测试,改名成
TestXXXDisabled比加t.Skip()更可靠——因为后者仍会进入执行流程,可能触发副作用
testing.T 方法调用顺序和作用边界
t.Fatal 和 t.Error 看似相似,但行为完全不同:前者立即终止当前测试函数,后者只记录错误并继续执行。很多初学者误用 t.Error 后还接着做断言或清理,导致 panic 或状态污染。
- 校验失败必须中断后续逻辑时,用
t.Fatal或t.Fatalf(例如依赖初始化失败) - 多个独立断言建议用
t.Errorf,避免单点失败掩盖其他问题 -
t.Cleanup()注册的函数总是在测试函数返回前执行,包括被t.Fatal中断的情况——适合关文件、删临时目录等确定性清理 -
t.Log输出仅在go test -v时可见;调试时别依赖它“看输出”,要用t.Logf("got %v, want %v", got, want)把上下文打全
测试文件命名与包作用域限制
Go 要求测试文件名必须以 _test.go 结尾,且默认与被测代码在同一包内(即 package mypkg)。这种“同包测试”能直接访问未导出函数和字段,是 Go 推荐做法,但也带来一个关键约束:你无法在测试文件里 import 当前包的别名或重复声明同名包。
立即学习“go语言免费学习笔记(深入)”;
- 不要手动写
package mypkg_test来隔离——那是黑盒测试模式,仅当需要模拟外部调用或避免访问内部实现时才启用 - 若测试文件用了
package mypkg_test,就不能直接调用myfunc()(未导出)或访问someUnexportedVar - 基准测试(
BenchmarkXXX)和示例测试(ExampleXXX)也必须遵守相同命名和文件规则,只是函数签名不同
最容易被忽略的是测试并发安全:Go 测试默认并发执行所有 TestXXX 函数,但如果测试里用了共享变量(比如全局 map 或缓存),又没加锁或重置,就可能出现偶发失败。每次写完测试,记得跑一遍 go test -race。不是所有竞态都能被检测到,但至少能拦住常见读写冲突。










