- http://c.biancheng.net/view/124.html
- https://geektutu.com/post/geecache-day2.html
Golang拥有一套单元测试和性能测试系统 - go test 命令
- 单元测试(UT, unit testing)
单元测试是指对软件中的最小可测试单元进行检查和验证，对于单元测试中单元的含义，一般要根据实际情况去判定其具体含义。
单元测试是在软件开发过程中要进行的最低级别的测试活动，软件的独立单元将在与程序的其他部分相隔离的情况下进行测试。
- 性能测试
性能测试又称为基准测试，是一种测试代码执行性能的方式。
基准测试主要是通过测试CPU和内存的分配来展示被测试代码的性能，进而找到性能更优的解决方案。
测试命令
- 测试文件名必须为
*_test.go
go test命令会自动读取源码目录下名为*_test.go的文件，生成并运行测试用的可执行文件。
$ go help test
$ go help testflag执行模式
go test具有两种执行模式
- 本地目录模式
local mode
本地模式即直接cd到特定目录中运行go test，不用指定目录。
在没有包参数(例如go test或go test -v)调用时发生，在此模式下go test编译当前目录中找到的包和测试，然后运行测试二进制文件。在本地目录模式下缓存是禁用的。包测试完成后go test会打印一行概要，显示测试状态、包名、运行时间。
- 包列表模式
package list mode
在任意目录中运行go test，需指定要测试的package目录。
在使用显示包参数调用go test时发生，例如go test math、go test ./...甚至是go test .。在此模式下go测试编译并测试在命令行列出每个包。如果一个包测试通过，go test只打印最终的ok总结行。如果一个包测试失败，go test将输出完整的测试输出。如果使用-bench或-v标志则go test会输出完整的输出，甚至是通过包测试，以显示锁请求的基准测试结果或详细日志记录。
在local mode中无缓存功能，在package list mode中测试成功的会被缓存，若后续没有改过测试函数，也没有改过被测试函数，那么将直接使用缓存的结果以加速整个测试。
// 清理所有缓存，包括测试缓存。
$ go clean -cache
//只清理测试缓存
$ go clean --testcache测试用例
在*_test.go文件中有三种类型的函数：测试函数、基准测试、示例函数
- 功能测试：函数名必须以
Test开头，函数参数必须是*testing.T。测试成立逻辑行为是否正确。 - 性能测试：函数名必须以
Benchmark开头，函数参数必须是*testing.B。测试函数的性能。 - 示例测试：函数名必须以
Example开头，函数参数无要求。为文档提供示例文档。
测试函数中某条测试用例执行结果与预期不符可调用t.Error()或t.Errorf()方法记录日志并标记测试失败
测试用例具有四种形式
- 基本测试用例：
TestXxx(t *testing.T) - 压力测试用例：
BenchmarkXxx(b *testing.B) - 测试控制台输出：
Example_Xxx() - 测试主函数：
TestMain(m *testing.M)
功能测试
- 功能测试用于测试程序的一些逻辑行为是否正确
-
go test命令会调用测试函数并报告测试结果是PASS或FAIL - 每个功能测试函数必须导入
testing包 - 功能测试函数是以
Test*为函数前缀的函数，但首字母不能是小写字母。
$ vim ./test/cache_test.gopackage test
import (
"fmt"
"testing"
)
func TestMain(m *testing.M) {
fmt.Printf("test main\n")
m.Run()
}
func TestCache(t *testing.T) {
fmt.Printf("Test Cache\n")
}测试文件以TestMain函数作为初始化test的入口，可以在m.Run()函数前完成初始化操作。若没有TestMain中调用m.Run()则除了TestMain()以外的其他test都不会执行。如果没有重写TestMain()则默认都会执行test。
测试整个文件
$ go test
test main
Test Cache
PASS
ok gfw/test 0.291s显示测试详情
- 直接输入
go test不会打印t.Log记录的信息，打印日志可采用go test -v。 -
go test -v显示测试的详细命令
$ go test -v
test main
testing: warning: no tests to run
PASS
ok gfw/test 0.293s测试单个文件需要带上被测试的源文件
$ go test -v cache_test.go
test main
=== RUN TestCache
Test Cache
--- PASS: TestCache (0.00s)
PASS
ok command-line-arguments 0.294s-
PASS表示测试成功 -
ok表示测试通过，command-line-arguments表示测试用例需要用到的一个包名，0.294s表示测试耗费的时长。
测试单个函数
-
go test指定文件时默认会执行文件内的所有测试用例 -
go test -run可使用-run参数选择需要的测试用例单独执行
$ go test -v cache_test.go -test.run TestCache
test main
=== RUN TestCache
Test Cache
--- PASS: TestCache (0.00s)
PASS
ok command-line-arguments 0.291s单元测试日志
- 每个测试用例可能并发执行，使用
testing.T提供的日志输出可以保证日志跟随测试上下文一起打印输出。 -
testing.T提供的日志输出方法
| 日志方法 | 描述 |
|---|---|
| Log | 打印日志，同时结束测试。 |
| Logf | 格式化打印日志，同时结束测试。 |
| Error | 打印错误日志，同时结束测试。 |
| Errorf | 格式化打印错误日志，同时结束测试。 |
| Fatal | 打印致命日志，同时结束测试。 |
| Fatalf | 格式化打印致命日志，同时结束测试。 |
标记单元测试结果
- 当需要终止当前测试用例时可使用
t.FailNow()方法 - 当只需要标记错误而不终止测试可采用
t.FailNow()方法
package test
import (
"testing"
)
func TestCache(t *testing.T) {
t.Log("TEST CACHE START...")
t.FailNow()
t.Log("TEST CACHE END...")
}$ go test -v -run TestCache cache_test.go
=== RUN TestCache
cache_test.go:8: TEST CACHE START...
--- FAIL: TestCache (0.00s)
FAIL
FAIL command-line-arguments 0.306s
FAIL基准测试 - benchmark test
基准测试框架对一个测试用例的默认测试时间为1秒，开始测试时当以Benchmark开头的基准测试用例函数返回时还不到1秒，那么testing.B中的N值将按1、2、5、10、20、50...递增，同时以递增后的值重新调用基准测试用例函数。
- 基准测试可测试一段程序的运行性能及耗费CPU的程度
-
go test工具提供了压力测试功能的支持 -- benchmark test -
go test的基准测试提供了将目标代码执行N次统计运行时间从而实现压测的功能
与单元测试类似只要在项目的*_test.go文件中写入BenchmarkXxx(b *testing.B)函数即可实现基准测试函数的编写。执行基准测试命令go test -bench=.即可获取测试结果。
- 测试文件必须以
*_test.go结尾 - 测试文件必须导入
testing包 - 测试函数名必须以
Benchmark开头，函数签名必须接收一个指向testing.B类型的指针，无返回值。 - 测试函数循环上限为
b.N
package test
import (
"fmt"
"testing"
)
func BenchmarkCache(b *testing.B) {
for i := 0; i < b.N; i++ {
fmt.Printf("%v\n", i)
}
}例如：
$ vim ./test/cache_test.gopackage test
import (
"fmt"
"testing"
)
func BenchmarkCache(b *testing.B) {
fmt.Printf("%v\n", "BENCHMARK...")
}$ go test -bench=BenchmarkCache -benchmem -benchtime=10s
BENCHMARK...
goos: windows
goarch: amd64
pkg: gfw/test
BenchmarkCache-6 BENCHMARK...
BENCHMARK...
BENCHMARK...
BENCHMARK...
BENCHMARK...
1000000000 0 B/op 0 allocs/op
PASS
ok gfw/test 0.298s意味着基准测试函数在测试时间内循环了1000000000次
go test -bench=".*" [-v]目录下全部单元测试和基准测试
可通过-bench=BenchmarkXxx目录下指定基准测试函数
$ go test -bench=BenchmarkCache可通过-benchtime来指定测试的执行时间，默认不小于1秒。
$ go test -bench=. -benchtime=20s可通过-benchmem显示每次操作分配内存的次数(allocs/op)和字节数(B/op)。
$ go test -bench=. -benchmem控制计数器
当测试需要一定的启动和初始化时间，若从Benchmark()函数开始计时时会很大成都上影响测试结果的精准性。
testing.B提供了一系列的方法可以方便地控制计时器，从而让计时器只在需要的区间进行测试。
package test
import (
"testing"
)
func BenchmarkCache(b *testing.B) {
//b.ResetTimer()//重置计时器
//b.StopTimer() //停止计时器
//b.StartTimer() //开始计时器
}并行执行测试 - Parallelizing tests
默认情况下，指定包的测试是按照顺序执行的，但也可以通过测试的函数内部使用t.Parallel()来标志某些测试也可以被安全的并发执行。
package test
import (
"testing"
)
func TestParallel(t *testing.T) {
t.Parallel()
}在并行执行的情况下，只有当那些被标记为并行的测试才会被并行执行，所以只有一个测试函数时是没有意义的。它应该在测试函数中第一个被调用，因为它会重置测试时间。
在并发情况下，同时运行的测试的数量默认取决于GOMAXPROCS，可通过-parallel n被指定。
$ go test -parallel 4另外，一个可以实现并行的方法，尽管不是函数级力度，但却是包级粒度，类似执行go test p1 p2 p3，即同时执行多个测试包。在这种情况下，包会被先编译，并同时被执行。当然，这对于总的时间来说是有好处的。但它也可能会导致错误变得具有不可预测性。比如一些资源被多个包同时使用时。
为了保持可控性，-p标志可以用来指定编译和测试的并发数。当仓库中有多个测试包，并且每个包在不同的子目录中，一个可以执行所有包的命令是go test ./...，这包含当前目录和所有子目录。没有带-p标志执行时，总的运行时间应该接近于运行时间最长的包的时间(加上编译时间)。
$ go test -p 1 .运行go test -p 1 ./...使编译和测试工具只能在一个包中执行时，总的时间应该接近于所有独立的包测试的时间加上编译的时间综合。