Go单元测试基础

Go语言测试

go test工具

Go语言中的测试依赖go test命令。编写测试代码和编写普通的Go代码过程是类似的，并不需要学习新的语法、规则或工具。

go test命令是一个按照一定约定和组织的测试代码的驱动程序。在包目录内，所有以_test.go为后缀名的源代码文件都是go test测试的一部分，不会被go build编译到最终的可执行文件中。

在*_test.go文件中有三种类型的函数，单元测试函数、基准测试函数和示例函数。

类型 格式 作用
测试函数 函数名前缀为Test 测试程序的一些逻辑行为是否正确
基准函数 函数名前缀为Benchmark 测试函数的性能
示例函数 函数名前缀为Example 为文档提供示例文档

go test命令会遍历所有的*_test.go文件中符合上述命名规则的函数，然后生成一个临时的main包用于调用相应的测试函数，然后构建并运行、报告测试结果，最后清理测试中生成的临时文件。

单元测试函数

格式

每个测试函数必须导入testing包，测试函数的基本格式（签名）如下：

1
2
3
func TestName(t *testing.T){
    // ...
}

测试函数的名字必须以Test开头，可选的后缀名必须以大写字母开头。

其中参数t用于报告测试失败和附加的日志信息。 testing.T的拥有的方法如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
func (c *T) Cleanup(func())
func (c *T) Error(args ...interface{})
func (c *T) Errorf(format string, args ...interface{})
func (c *T) Fail()
func (c *T) FailNow()
func (c *T) Failed() bool
func (c *T) Fatal(args ...interface{})
func (c *T) Fatalf(format string, args ...interface{})
func (c *T) Helper()
func (c *T) Log(args ...interface{})
func (c *T) Logf(format string, args ...interface{})
func (c *T) Name() string
func (c *T) Skip(args ...interface{})
func (c *T) SkipNow()
func (c *T) Skipf(format string, args ...interface{})
func (c *T) Skipped() bool
func (c *T) TempDir() string

示例

一个软件程序也是由很多单元组件构成的。单元组件可以是函数、结构体、方法和最终用户可能依赖的任意东西。总之我们需要确保这些组件是能够正常运行的。单元测试是一些利用各种方法测试单元组件的程序，它会将结果与预期输出进行比较。

接下来，我们在base包中定义了一个Split函数，具体实现如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
package base

import "strings"

// Split 把字符串s按照给定的分隔符sep进行分割返回字符串切片
func Split(s, sep string) (result []string) {
    i := strings.Index(s, sep)

    for i > -1 {
        result = append(result, s[:i])
        s = s[i+1:]
        i = strings.Index(s, sep)
    }
    result = append(result, s)
    return
}

在当前目录下，我们创建一个split_test.go的测试文件，并定义一个测试函数如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
package base

import (
    "reflect"
    "testing"
)

func TestSplit(t *testing.T) {
    // 程序输出的结果
    got := Split("a:b:c", ":")
    // 期望的结果
    want := []string{"a", "b", "c"}
    // slice不能比较直接，借助反射包中的方法比较
    if !reflect.DeepEqual(want, got) {
        t.Errorf("expected:%v, got:%v", want, got)
    }
}

在当前路径下执行go test ./base命令，可以看到输出结果如下：

1
ok      TestLearingProject/base 0.072s

go test -v

一个测试用例有点单薄，我们再编写一个测试使用多个字符切割字符串的例子，在split_test.go中添加如下测试函数：

1
2
3
4
5
6
7
func TestSplitWithComplexSep(t *testing.T) {
    got := Split("abcd", "bc")
    want := []string{"a", "d"}
    if !reflect.DeepEqual(want, got) {
        t.Errorf("expected:%v, got:%v", want, got)
    }
}

现在我们有多个测试用例了，为了能更好的在输出结果中看到每个测试用例的执行情况，我们可以为go test命令添加-v参数，它会输出每个单独的测试函数的运行结果，包括测试通过的函数和失败的函数，以及每个测试函数的运行时间，获得更详细的测试结果。运行go test ./base -v命令。

得到结果：

1
2
3
4
5
6
7
8
=== RUN   TestSplit
--- PASS: TestSplit (0.00s)
=== RUN   TestSplitWithComplexSep
    split_test.go:23: expected:[a d], got:[a cd]
--- FAIL: TestSplitWithComplexSep (0.00s)
FAIL
FAIL    TestLearingProject/base 0.107s
FAIL

从上面的输出结果我们能清楚的看到是TestSplitWithComplexSep这个测试用例没有测试通过。

go test -run

单元测试的结果表明split函数的实现并不可靠，没有考虑到传入的sep参数是多个字符的情况，下面我们来修复下这个Bug：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
package base

import "strings"

// Split 把字符串s按照给定的分隔符sep进行分割返回字符串切片
func Split(s, sep string) (result []string) {
    i := strings.Index(s, sep)

    for i > -1 {
        result = append(result, s[:i])
        s = s[i+len(sep):]
        i = strings.Index(s, sep)
    }
    result = append(result, s)
    return
}

在执行go test命令的时候可以添加-run参数，它对应一个正则表达式，只有函数名匹配上的测试函数才会被go test命令执行。

例如通过给go test添加-run=Sep参数来告诉它本次测试只运行测试函数名包含Sep的测试用例，即TestSplitWithComplexSep这个测试用例。运行go test ./base -run=Sep -v命令。

1
2
3
4
=== RUN   TestSplitWithComplexSep
--- PASS: TestSplitWithComplexSep (0.00s)
PASS
ok      TestLearingProject/base 0.335s

最终的测试结果表情我们成功修复了之前的Bug。

回归测试

我们修改了代码之后仅仅执行那些失败的测试用例或新引入的测试用例是错误且危险的，正确的做法应该是完整运行所有的测试用例，保证不会因为修改代码而引入新的问题。运行go test ./base -v命令。

1
2
3
4
5
6
=== RUN   TestSplit
--- PASS: TestSplit (0.00s)
=== RUN   TestSplitWithComplexSep
--- PASS: TestSplitWithComplexSep (0.00s)
PASS
ok      TestLearingProject/base 0.294s

测试结果表明我们的单元测试全部通过。

跳过某些测试用例

为了节省时间支持在单元测试时跳过某些耗时的测试用例。

1
2
3
4
5
6
func TestTimeConsuming(t *testing.T) {
    if testing.Short() {
        t.Skip("short模式下会跳过该测试用例")
    }
    ...
}

当执行go test -short时就不会执行上面的TestTimeConsuming测试用例。

子测试

在上面的示例中我们为每一个测试数据编写了一个测试函数，而通常单元测试中需要多组测试数据保证测试的效果。Go1.7+中新增了子测试，支持在测试函数中使用t.Run执行一组测试用例，这样就不需要为不同的测试数据定义多个测试函数了。

1
2
3
4
5
func TestXXX(t *testing.T){
    t.Run("case1", func(t *testing.T){...})
    t.Run("case2", func(t *testing.T){...})
    t.Run("case3", func(t *testing.T){...})
}

表格驱动测试

介绍

表格驱动测试不是工具、包或其他任何东西，它只是编写更清晰测试的一种方式和视角。

编写好的测试并非易事，但在许多情况下，表格驱动测试可以涵盖很多方面：表格里的每一个条目都是一个完整的测试用例，包含输入和预期结果，有时还包含测试名称等附加信息，以使测试输出易于阅读。

使用表格驱动测试能够很方便的维护多个测试用例，避免在编写单元测试时频繁的复制粘贴。

表格驱动测试的步骤通常是定义一个测试用例表格，然后遍历表格，并使用t.Run对每个条目执行必要的测试。

示例

官方标准库中有很多表格驱动测试的示例，例如fmt包中便有如下测试代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
var flagtests = []struct {
    in  string
    out string
}{
    {"%a", "[%a]"},
    {"%-a", "[%-a]"},
    {"%+a", "[%+a]"},
    {"%#a", "[%#a]"},
    {"% a", "[% a]"},
    {"%0a", "[%0a]"},
    {"%1.2a", "[%1.2a]"},
    {"%-1.2a", "[%-1.2a]"},
    {"%+1.2a", "[%+1.2a]"},
    {"%-+1.2a", "[%+-1.2a]"},
    {"%-+1.2abc", "[%+-1.2a]bc"},
    {"%-1.2abc", "[%-1.2a]bc"},
}

func TestFlagParser(t *testing.T) {
    var flagprinter flagPrinter
    for _, tt := range flagtests {
        t.Run(tt.in, func(t *testing.T) {
            s := Sprintf(tt.in, &flagprinter)
            if s != tt.out {
                t.Errorf("got %q, want %q", s, tt.out)
            }
        })
    }
}

通常表格是匿名结构体切片，可以定义结构体或使用已经存在的结构进行结构体数组声明。name属性用来描述特定的测试用例。

接下来让我们试着自己编写表格驱动测试：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
func TestSplitAll(t *testing.T) {
    // 定义测试表格
    // 这里使用匿名结构体定义了若干个测试用例
    // 并且为每个测试用例设置了一个名称
    tests := []struct {
        name  string
        input string
        sep   string
        want  []string
    }{
        {"base case", "a:b:c", ":", []string{"a", "b", "c"}},
        {"wrong sep", "a:b:c", ",", []string{"a:b:c"}},
        {"more sep", "abcd", "bc", []string{"a", "d"}},
        {"leading sep", "abcdacd", "a", []string{"", "bcd", "cd"}},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            got := Split(tt.input, tt.sep)
            if !reflect.DeepEqual(got, tt.want) {
                t.Errorf("expected:%#v, got:%#v", tt.want, got)
            }
        })
    }
}

在终端执行go test ./base -v，会得到如下测试输出结果：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
=== RUN   TestSplit
--- PASS: TestSplit (0.00s)
=== RUN   TestSplitWithComplexSep
--- PASS: TestSplitWithComplexSep (0.00s)
=== RUN   TestSplitAll
=== RUN   TestSplitAll/base_case
=== RUN   TestSplitAll/wrong_sep
=== RUN   TestSplitAll/more_sep
=== RUN   TestSplitAll/leading_sep
--- PASS: TestSplitAll (0.00s)
    --- PASS: TestSplitAll/base_case (0.00s)
    --- PASS: TestSplitAll/wrong_sep (0.00s)
    --- PASS: TestSplitAll/more_sep (0.00s)
    --- PASS: TestSplitAll/leading_sep (0.00s)
PASS
ok      TestLearingProject/base 0.331s

并行测试

表格驱动测试中通常会定义比较多的测试用例，而Go语言又天生支持并发，所以很容易发挥自身并发优势将表格驱动测试并行化。 想要在单元测试过程中使用并行测试，可以像下面的代码示例中那样通过添加t.Parallel()来实现。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
func TestSplitAll(t *testing.T) {
    t.Parallel() // 将 TLog 标记为能够与其他测试并行运行

    tests := []struct {
        name  string
        input string
        sep   string
        want  []string
    }{
        {"base case", "a:b:c", ":", []string{"a", "b", "c"}},
        {"wrong sep", "a:b:c", ",", []string{"a:b:c"}},
        {"more sep", "abcd", "bc", []string{"a", "d"}},
        {"leading sep", "abcdacd", "a", []string{"", "bcd", "cd"}},
    }

    for _, tt := range tests {
        tt := tt // 注意这里重新声明tt变量（避免多个goroutine中使用了相同的变量）
        t.Run(tt.name, func(t *testing.T) {
            t.Parallel() // 将每个测试用例标记为能够彼此并行运行
            got := Split(tt.input, tt.sep)
            if !reflect.DeepEqual(got, tt.want) {
                t.Errorf("expected:%#v, got:%#v", tt.want, got)
            }
        })
    }
}

这样我们执行go test ./base -v的时候就会看到每个测试用例并不是按照我们定义的顺序执行，而是互相并行了。

说明：

在Go语言中，匿名函数可以捕获外部变量，这意味着它们可以访问外部函数中定义的变量。但在循环中使用匿名函数时，通常会导致闭包捕获的变量是循环变量的最终值，而不是每次迭代的值。这可能会导致意外行为，尤其是在并发执行的情况下。

通过在循环内部创建一个新的变量，其值等于当前迭代的循环变量值，可以确保每个匿名函数都引用的是正确的变量值，而不是循环结束时的最终值。

因此，tt := tt这行代码的作用是创建一个新的变量tt，其值等于当前迭代的tt，从而确保在循环内部创建的匿名函数引用的是正确的变量值。

使用工具生成测试代码

社区里有很多自动生成表格驱动测试函数的工具，比如gotests等，很多编辑器如Goland也支持快速生成测试文件。这里简单演示一下gotests的使用。

安装

1
go get -u github.com/cweill/gotests/...

执行

1
gotests -all -w split.go

上面的命令表示，为split.go文件的所有函数生成测试代码至split_test.go文件（目录下如果事先存在这个文件就不再生成）。

生成的测试代码大致如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
package base

import (
    "reflect"
    "testing"
)

func TestSplit(t *testing.T) {
    type args struct {
        s   string
        sep string
    }
    tests := []struct {
        name       string
        args       args
        wantResult []string
    }{
        // TODO: Add test cases.
    }
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            if gotResult := Split(tt.args.s, tt.args.sep); !reflect.DeepEqual(gotResult, tt.wantResult) {
                t.Errorf("Split() = %v, want %v", gotResult, tt.wantResult)
            }
        })
    }
}

代码格式与我们上面的类似，只需要在TODO位置添加我们的测试样例就可以了。

测试覆盖率

测试覆盖率是指代码被测试套件覆盖的百分比。通常我们使用的都是语句的覆盖率，也就是在测试中至少被运行一次的代码占总代码的比例。在公司内部一般会要求测试覆盖率达到80%左右。

Go提供内置功能来检查你的代码覆盖率，即使用go test ./base -cocer来查看测试覆盖率。

1
ok      TestLearingProject/base 0.348s  coverage: 100.0% of statements

从上面的结果可以看到我们的测试用例覆盖了100%的代码。

Go还提供了一个额外的-coverprofile参数，用来将覆盖率相关的记录信息输出到一个文件。例如运行go test ./base -cover -coverprofile=/base/split命令：

1
ok      TestLearingProject/base 0.391s  coverage: 100.0% of statements

然后我们执行go tool cover -html=base/split，使用cover工具来处理生成的记录信息，该命令会打开本地的浏览器窗口生成一个HTML报告。

上图中每个用绿色标记的语句块表示被覆盖了，而红色的表示没有被覆盖。

testify/assert

testify是一个社区非常流行的Go单元测试工具包，其中使用最多的功能就是它提供的断言工具——testify/assert或testify/require。

安装

1
go get github.com/stretchr/testify

使用示例

我们在写单元测试的时候，通常需要使用断言来校验测试结果，但是由于Go语言官方没有提供断言，所以我们会写出很多的if...else...语句。而testify/assert为我们提供了很多常用的断言函数，并且能够输出友好、易于阅读的错误描述信息。

比如我们之前在TestSplit测试函数中就使用了reflect.DeepEqual来判断期望结果与实际结果是否一致。

1
2
3
4
5
6
t.Run(tt.name, func(t *testing.T) {
    got := Split(tt.input, tt.sep)
    if !reflect.DeepEqual(got, tt.want) {
        t.Errorf("expected:%#v, got:%#v", tt.want, got)
    }
})

使用testify/assert之后就能将上述判断过程简化如下：

1
2
3
4
t.Run(tt.name, func(t *testing.T) {
    got := Split(tt.input, tt.sep)
    assert.Equal(t, got, tt.want)  // 使用assert提供的断言函数
})

当我们有多个断言语句时，还可以使用assert := assert.New(t)创建一个assert对象，它拥有前面所有的断言方法，只是不需要再传入Testing.T参数了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
func TestSomething(t *testing.T) {
    assert := assert.New(t)

    // assert equality
    assert.Equal(123, 123, "they should be equal")

    // assert inequality
    assert.NotEqual(123, 456, "they should not be equal")

    // assert for nil (good for errors)
    assert.Nil(object)

    // assert for not nil (good when you expect something)
    if assert.NotNil(object) {

        // now we know that object isn't nil, we are safe to make
        // further assertions without causing any errors
        assert.Equal("Something", object.Value)
    }
}

testify/assert提供了非常多的断言函数，这里没办法一一列举出来，大家可以查看官方文档了解。

testify/require拥有testify/assert所有断言函数，它们的唯一区别就是——testify/require遇到失败的用例会立即终止本次测试。

此外，testify包还提供了mock、http等其他测试工具，篇幅所限这里就不详细介绍了，有兴趣的同学可以自己了解一下。

开发
#Go
Go单元测试基础
https://serendipity565.github.io/posts/4ed0fa7f9aed/
作者
Serendipity
发布于
2024年4月12日
许可协议
BY-SERENDIPITY565