约束：

使用go自身的单元测试框架testing包来写单元测试有如下约束：

• 单元测试，要导入 testing 包；
• 承载测试用例的测试文件，固定以 _test.go结尾；
• 测试用例函数名称一定要以 Test 开头，同时Test后的第一字母一定要大写，如TestSpec，写成这样Testspec不会被框架识别；
• 测试用例函数的参数有且只有一个，一般是 t *testing.T。

命令：

测试用例文件使用go test指令来执行，没有也不需要 main() 作为函数入口；

所有在以_test结尾的源码内以Test开头的函数会自动被执行；

测试用例文件不会参与正常源码编译，不会被包含到可执行文件中。

go test常见选项：

使用示例：

1. 运行整个项目的测试文件：

$ go test
PASS
ok      _/home/wangbm/golang/math   0.003s

2. 只运行某个测试文件（ math_test.go， math.go 是一对，缺一不可，前后顺序可对调）

$ go test math_test.go math.go
ok      command-line-arguments  0.002s

3. 加-v查看详细结果

$ go test math_test.go math.go
=== RUN   TestAdd
    TestAdd: main_test.go:22: the result is ok
    TestAdd: main_test.go:22: the result is ok
    TestAdd: main_test.go:22: the result is ok
    TestAdd: main_test.go:22: the result is ok
    TestAdd: main_test.go:22: the result is ok
--- PASS: TestAdd (0.00s)
PASS
ok      command-line-arguments  0.003s

4. 只测试某个函数，-run 支持正则，如下例子中 TestAdd，如果还有一个测试函数为 TestAdd02，那么它也会被运行。

$ go test -v -run="TestAdd"
=== RUN   TestAdd
    TestAdd: math_test.go:22: the result is ok
    TestAdd: math_test.go:22: the result is ok
    TestAdd: math_test.go:22: the result is ok
    TestAdd: math_test.go:22: the result is ok
    TestAdd: math_test.go:22: the result is ok
--- PASS: TestAdd (0.00s)
PASS
ok      _/home/wangbm/golang/math   0.003s

5. 生成 test 的二进制文件：加 -c 参数

   $ go test -v -run="TestAdd" -c
   $
   $ ls -l
   total 3208
   -rw-r--r-- 1 root root      95 May 25 20:56 math.go
   -rwxr-xr-x 1 root root 3272760 May 25 21:00 math.test
   -rw-r--r-- 1 root root     525 May 25 20:56 math_test.go

IDE配置：

使用goland来写单元测试时，需要添加一个Go Test的配置，否则无法在goland里面运行测试。

go_test.png

示例：

代码可以从github下载：recipes/go/fizzbuzzwhizz at main · yanxicheung/recipes (github.com)

package main

import (
    "testing"
)

func TestSpec_Example_Succ1(t *testing.T) {
    t.Log("example go test1")
    cases := []struct {
        input    int
        expected string
    }{{1, "1"},
        {5, "Buzz"},
        {30, "Fizz"},
        {105, "FizzBuzzWhizz"},
    }

    r := spec(3, 5, 7)
    for _, elem := range cases {
        actual := r(elem.input)
        if actual != elem.expected {
            t.Errorf("failed! input %d, expected %v, actual %v", elem.input, elem.expected, actual)
        }
    }
}

//一个测试用例还可以分为多个子测试用例
func TestSpec_Example_Succ2(t *testing.T) {
    r := spec(3, 5, 7)
    t.Run("should_times_succ", func(t *testing.T) {
        cases := []struct {
            input    int
            expected string
        }{
            {3, "Fizz"},
            {5, "Buzz"},
            {7, "Whizz"}}

        for _,elem:=range cases{
            actual:=r(elem.input)
            if actual != elem.expected {
                t.Errorf("failed! input %d, expected %v, actual %v", elem.input, elem.expected, actual)
            }
        }
    })

    t.Run("should_contains_succ", func(t *testing.T) {
        cases := []struct {
            input    int
            expected string
        }{
            {30, "Fizz"},
            {31, "Fizz"},
        }

        for _,elem:=range cases{
            actual:=r(elem.input)
            if actual != elem.expected {
                t.Errorf("failed! input %d, expected %v, actual %v", elem.input, elem.expected, actual)
            }
        }
    })
}

参考文献：

1. 6.1 Go 命令：go test 工具详解
2. 6.2 单元测试：如何进行单元测试
3. 8.1 测试技巧：单元测试