Testify for Go：完整指南及示例

什么是 Testify，为什么需要它？

Testify 是 Go 语言中最流行的测试库之一。它扩展了标准 testing 包的功能，为开发者提供了编写清晰、可读且可维护测试的强大工具。Testify 解决了 Go 开发者面临的几个关键问题：

• 简化断言： 代替冗长的 if 和 t.Errorf 结构，Testify 提供了诸如 assert.Equal 这样简洁的方法。
• 错误可读性： 当测试失败时，Testify 会输出详细的错误信息，显示期望值和实际值。
• 创建模拟对象： 内置的模拟支持可以轻松地将被测试代码与外部依赖（数据库、HTTP 客户端、文件系统）隔离开来。
• 测试分组： 允许将测试组织成逻辑组，并共享通用设置（Setup/Teardown）。

Testify 非常适合任何规模的项目——从小型工具到大型微服务架构。它是 Go 社区中事实上的测试标准。

安装

Testify 作为普通的 Go 依赖项进行安装。请确保您已安装 Go（版本 1.16 或更高）并初始化了模块（go mod init）。

go get github.com/stretchr/testify

执行命令后，Testify 将被添加到您的 go.mod 文件中。现在您可以在测试文件中导入它。

快速入门

让我们为一个将两个数相加的函数编写一个简单的测试。创建文件 math.go：

package main

func Add(a, b int) int {    return a + b}

现在创建测试文件 math_test.go：

package main

import (    "testing"    "github.com/stretchr/testify/assert")

func TestAdd(t *testing.T) {    result := Add(2, 3)    expected := 5    assert.Equal(t, expected, result, "2 + 3 应该等于 5")}

运行测试：

go test -v

您将看到绿色的测试通过结果。如果将期望值改为 6，测试将失败并显示详细的错误信息。

主要方法和函数

1. assert.Equal

描述： 检查两个值是否相等。对于复杂类型（切片、结构体、映射），使用 reflect.DeepEqual 进行比较。

参数：

• t — *testing.T 对象
• expected — 期望值
• actual — 实际值
• msg（可选）— 错误消息

示例：

func TestEqual(t *testing.T) {    assert.Equal(t, 10, 5+5, "5+5 应该等于 10")    assert.Equal(t, []int{1, 2, 3}, []int{1, 2, 3})}

2. assert.NotEqual

描述： 与 Equal 相反。检查两个值是否不相等。

参数： 与 Equal 类似。

示例：

func TestNotEqual(t *testing.T) {    assert.NotEqual(t, 10, 5+4, "5+4 不等于 10")}

3. assert.True / assert.False

描述： 检查表达式是否为真（True）或假（False）。

参数：

• t — *testing.T 对象
• condition — 布尔表达式
• msg（可选）— 错误消息

示例：

func TestTrueFalse(t *testing.T) {    assert.True(t, 5 > 3, "5