在Golang项目开发中，编写单元测试是保障代码逻辑正确性的重要手段，Golang标准库自带的testing包已经提供了完善的单元测试支持，能够满足大部分基础测试需求。
Golang单元测试基础规则
使用testing包编写单元测试需要遵循固定的文件命名和函数命名规范，否则测试框架无法识别测试用例。
文件与函数命名要求
单元测试文件需要以_test.go作为后缀，和待测试的代码文件放在同一个包下。测试函数的命名必须以Test开头，后面跟随大写字母开头的函数名，并且函数的参数固定为*testing.T类型，示例如下：
// 待测试的函数，放在math_utils.go文件中
package utils
func Add(a, b int) int {
return a + b
}
// 对应的测试文件math_utils_test.go
package utils
import "testing"
// 测试Add函数的用例
func TestAdd(t *testing.T) {
result := Add(1, 2)
if result != 3 {
t.Errorf("Add(1,2) = %d, 期望结果为3", result)
}
}
常用testing包方法
在测试函数中，我们可以通过*testing.T提供的方法输出测试结果：
- t.Log(args ...interface{})：输出普通日志信息，默认不会显示，需要添加
-v参数运行测试才会展示 - t.Errorf(format string, args ...interface{})：标记测试用例失败，并输出格式化错误信息
- t.Fatal(args ...interface{})：标记测试用例失败，并终止当前测试函数的执行
- t.Run(name string, f func(t *testing.T))：运行子测试，方便对同一个函数的多个测试场景进行分组管理
使用testify简化断言逻辑
标准库的testing包需要手动编写条件判断来验证结果，当测试用例较多时会出现大量重复的if判断代码。我们可以引入第三方断言库testify来简化这一流程，testify提供了丰富的断言方法，让测试代码更简洁易读。
首先通过命令安装testify依赖：
go get github.com/stretchr/testify
使用testify的assert包改写之前的Add函数测试用例如下：
package utils
import (
"testing"
"github.com/stretchr/testify/assert"
)
func TestAddWithTestify(t *testing.T) {
// 断言结果等于3
assert.Equal(t, 3, Add(1, 2), "1加2的结果应该是3")
// 断言结果不等于4
assert.NotEqual(t, 4, Add(1, 2), "1加2的结果不应该等于4")
}
testify还支持更丰富的断言方法，比如assert.Nil验证对象是否为nil，assert.Contains验证字符串是否包含指定子串，assert.Greater验证数值大小关系等，开发者可以根据测试场景选择合适的断言方法。
子测试与测试分组
当我们需要测试同一个函数的多个不同输入场景时，可以使用子测试来组织用例，让测试结果更清晰。使用t.Run方法可以定义子测试，每个子测试都有独立的名称和结果展示：
func TestAddSubTests(t *testing.T) {
// 定义测试用例组
testCases := []struct {
name string
a int
b int
expected int
}{
{"正数相加", 1, 2, 3},
{"负数相加", -1, -2, -3},
{"正负混合相加", 1, -2, -1},
}
// 遍历用例组运行子测试
for _, tc := range testCases {
t.Run(tc.name, func(t *testing.T) {
result := Add(tc.a, tc.b)
assert.Equal(t, tc.expected, result)
})
}
}
统计代码覆盖率
代码覆盖率可以反映单元测试对代码的覆盖程度，帮助开发者发现未被测试覆盖的代码分支。Golang自带了覆盖率统计功能，运行测试时添加-cover参数即可查看覆盖率：
# 运行当前包下所有测试并统计覆盖率 go test -cover
如果需要生成详细的覆盖率报告文件，可以使用以下命令：
# 生成覆盖率数据文件 go test -coverprofile=coverage.out # 将覆盖率数据转换为HTML报告 go tool cover -html=coverage.out -o coverage.html
打开生成的coverage.html文件，就可以看到每一行代码是否被测试覆盖，红色表示未覆盖，绿色表示已覆盖，方便开发者针对性补充测试用例。
测试注意事项
- 测试函数不能接收除
*testing.T之外的其他参数，否则测试框架会报错 - 不要在测试代码中依赖外部环境的随机状态，比如当前时间、随机数等，避免测试结果不稳定
- 测试文件的包名可以和待测试代码的包名一致，也可以使用
包名_test的形式，后者只能访问待测试代码的导出方法 - 运行测试时添加
-count=1参数可以避免测试结果被缓存，确保每次运行都是最新的测试逻辑