Golang测试用例命名规范与执行方法

测试文件需以_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 命令可以执行当前目录下的所有测试用例。

NameGPT名称生成器

免费AI公司名称生成器，AI在线生成企业名称，注册公司名称起名大全。

0

查看详情

常用命令示例：

• go test：运行当前包的所有测试
• go test -v：显示详细输出，包括每个测试函数的执行情况
• go test -run TestFunctionName：运行特定测试函数，支持正则匹配
• go test ./...：递归运行项目中所有子目录的测试
• go test -cover：显示测试覆盖率

举例：

# 只运行名为 TestAdd 的测试
go test -run TestAdd
<h1>运行所有包含 "Parse" 的测试函数</h1><p>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"}},
    }
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">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项目稳健运行的基础。

以上就是Golang测试用例命名规范与执行方法的详细内容，更多请关注php中文网其它相关文章！