测试文件需以_test.go结尾,测试函数以Test开头并接收*testing.T参数,使用go test命令运行,推荐子测试划分场景,提升可维护性。

在Go语言开发中,测试是保障代码质量的重要环节。良好的测试用例命名规范和清晰的执行方式,有助于提升项目的可维护性和团队协作效率。
测试文件命名规范
Go中的测试文件必须以 _test.go 结尾,这样 go test 命令才能识别并执行其中的测试函数。这类文件与被测试的源码放在同一包目录下,通常与对应源文件同名。
例如:- 源文件为 calculator.go,测试文件应命名为 calculator_test.go
- 如果测试涉及整个包的功能,也可以使用 package_test.go 这样的命名
测试文件会导入被测试包的内容,属于同一个包(如同包测试),因此可以直接访问包内公开函数和变量。
测试函数命名规则
每个测试函数必须以 Test 开头,后接大写字母开头的名称,函数参数类型为 *testing.T。这是go test工具识别测试用例的依据。
立即学习“go语言免费学习笔记(深入)”;
标准格式:func TestXxx(t *testing.T) { ... }示例:
func TestAdd(t *testing.T) {
result := Add(2, 3)
if result != 5 {
t.Errorf("期望 5,实际 %d", result)
}
}建议命名方式:
- 动词 + 被测功能:如 TestCalculateInterest
- 场景化命名:如 TestParseJSONWithInvalidInput
- 避免使用下划线,采用驼峰式命名
运行测试的方法
使用 go test 命令可以执行当前目录下的所有测试用例。
常用命令示例:
- go test:运行当前包的所有测试
- go test -v:显示详细输出,包括每个测试函数的执行情况
- go test -run TestFunctionName:运行特定测试函数,支持正则匹配
- go test ./...:递归运行项目中所有子目录的测试
- go test -cover:显示测试覆盖率
举例:
# 只运行名为 TestAdd 的测试 go test -run TestAdd运行所有包含 "Parse" 的测试函数
go test -run Parse
子测试(Subtests)的使用
对于一个函数需要测试多种输入场景的情况,推荐使用子测试。它不仅结构清晰,还支持通过路径精确运行某个测试分支。
func TestSplit(t *testing.T) {
cases := []struct {
input string
sep string
want []string
}{
{"a:b:c", ":", []string{"a", "b", "c"}},
{"one,two", ",", []string{"one", "two"}},
}
for _, c := range cases {
t.Run(fmt.Sprintf("Split(%s,%s)", c.input, c.sep), func(t *testing.T) {
result := Split(c.input, c.sep)
if !reflect.DeepEqual(result, c.want) {
t.Errorf("期望 %v,实际 %v", c.want, result)
}
})
}}
执行某个子测试:
go test -run TestSplit/Split\(a:b:c,:)
基本上就这些。命名清晰、结构合理、可精准执行的测试,是Go项目稳健运行的基础。










