当前位置：首页 > 文章列表 > Golang > Go教程 > Golang单元测试编写与testing包使用教程

Golang单元测试编写与testing包使用教程

2026-02-04 15:45:40 0浏览收藏

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Golang单元测试编写方法及testing包使用指南》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

最简Go单元测试需满足三要素：文件名以_test.go结尾、函数名以Test开头、参数为*testing.T；示例中TestAdd调用Add(2,3)并用t.Errorf校验结果是否为5。

如何使用Golang编写单元测试_Golang testing包单元测试方法

怎么写一个最简可用的 Go 单元测试

Go 的 testing 包不需要额外安装，只要文件名以 _test.go 结尾、函数名以 Test 开头、参数为 *testing.T，就能被 go test 自动识别。

常见错误：把测试函数写成 func testAdd() {}（没带 *testing.T）或 func TestAdd(t *testing.T) error {}（返回值非 void），都会导致测试不运行或编译失败。

示例：

package calc

import "testing"

func TestAdd(t *testing.T) {
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("expected 5, got %d", result)
    }
}

如何用 t.Run 组织多个子测试用例

单个 Test* 函数里用 t.Run 可以跑多个逻辑相近但输入不同的测试，失败时能精准定位到具体子项，还能共享 setup/teardown 逻辑。

容易踩的坑：在循环中直接用循环变量做子测试名或传参，比如：

for _, tc := range cases { t.Run(tc.name, func(t *testing.T) { ... }) } —— 如果 tc 是指针或闭包捕获了循环变量，所有子测试可能共用最后一个 tc 值。

正确做法是用局部变量绑定：

for _, tc := range cases {
    tc := tc // 显式复制
    t.Run(tc.name, func(t *testing.T) {
        got := Add(tc.a, tc.b)
        if got != tc.want {
            t.Errorf("Add(%d,%d) = %d, want %d", tc.a, tc.b, got, tc.want)
        }
    })
}

怎样测 panic、error 和并发行为

Go 测试不能靠 try/catch 捕获 panic，必须用 func(){}() 匿名函数 + recover() 手动拦截；t.Fatal 会终止当前测试，t.Error 则继续执行后续断言。

测 panic：

func TestDividePanic(t *testing.T) {
    defer func() {
        if r := recover(); r == nil {
            t.Error("expected panic but didn't happen")
        }
    }()
    Divide(1, 0) // 假设这个函数会 panic
}

测 error 返回：直接检查返回的 error 是否为 nil 或是否包含预期字符串，避免用 fmt.Sprintf("%v", err) 做模糊匹配，应优先用 errors.Is 或 errors.As。
测 goroutine 行为：用 sync.WaitGroup 或 time.Sleep（不推荐）确保协程结束；更稳妥的是用 chan struct{} 通知完成，或借助 testify/assert 等库的超时机制。