Go 语言 testing 包是官方轻量高效内建测试框架,需将测试函数置于 _test.go 文件、以 Test 开头、接收 testing.T 参数;用 t.Error/t.Fatal 等方法报错,支持 t.Run 子测试和 go test -v/-cover 等实用选项。

Go 语言的 testing 包是官方提供的轻量、高效、内建的测试框架,无需额外依赖。编写单元测试时,只需遵循命名规范(测试函数以 Test 开头、参数为 *testing.T),并用 go test 命令运行即可。
定义测试函数的基本规则
测试函数必须放在以 _test.go 结尾的文件中,且与被测代码在同一包内(或使用 xxx_test 包做白盒 / 黑盒隔离)。函数签名固定为:
- 函数名以
Test开头,后接大写字母开头的有意义名称(如TestAdd、TestParseURL) - 唯一参数类型为
*testing.T - 不能有返回值
常用断言与错误报告方式
Go 不提供内置断言函数,而是通过 *testing.T 的方法显式控制测试流程:
-
t.Error(……):记录错误,继续执行后续语句 -
t.Errorf(……):带格式化字符串的错误记录(推荐用于含变量的提示) -
t.Fatal(……)和t.Fatalf(……):记录错误并立即终止当前测试函数 - 避免使用
panic或log.Fatal,它们会绕过测试框架,导致结果不可靠
例如验证加法函数:
func TestAdd(t *testing.T) {<br> got := Add(2, 3)<br> if got != 5 {<br> t.Errorf("Add(2,3) = %d, want 5", got)<br> }<br>}
使用子测试组织多个场景
用 t.Run() 可将一个测试函数拆分为多个逻辑子测试,便于分组、过滤和独立失败定位:
立即学习“go 语言免费学习笔记(深入)”;
- 每个子测试有自己的名字和 作用域,失败时显示完整路径(如
TestAdd/positive_numbers) - 支持用
-run参数只运行匹配的子测试:go test -run "TestAdd/positive" - 适合覆盖边界值、异常输入、不同配置等场景
示例:
func TestAdd(t *testing.T) {<br> t.Run("positive_numbers", func(t *testing.T) {<br> if got := Add(2, 3); got != 5 {<br> t.Errorf("expected 5, got %d", got)<br> }<br> })<br> t.Run("negative_numbers", func(t *testing.T) {<br> if got := Add(-1, -2); got != -3 {<br> t.Errorf("expected -3, got %d", got)<br> }<br> })<br>}
测试命令与实用选项
go test 是核心命令,配合参数可提升效率和可观测性:
-
go test:运行当前目录下所有*_test.go中的测试 -
go test -v:显示详细输出(包括每个测试函数名和日志) -
go test -run=^TestAdd$:正则匹配精确测试函数(^和$防止子串误匹配) -
go test -cover:显示测试覆盖率百分比 -
go test -coverprofile=c.out && go tool cover -html=c.out:生成 HTML 覆盖率报告