Go语言的标准测试库testing没有像其他语言那样提供内置的断言函数，开发者需要通过其他方式实现测试结果的判断和校验。不同的判断方式适用于不同的测试场景，选择合适的方案能让测试代码更清晰易维护。
使用标准库testing的直接判断方式
最基础的方式是直接通过if条件判断测试结果是否符合预期，不符合时调用t.Error或者t.Fatalf输出错误信息。这种方式不需要依赖任何第三方库，适合简单的测试场景。
t.Error会在测试失败时记录错误并继续执行后续测试，t.Fatalf则会在记录错误后立即终止当前测试函数的执行。
package main
import (
"testing"
)
// 待测试的函数
func add(a, b int) int {
return a + b
}
func TestAdd(t *testing.T) {
result := add(1, 2)
// 直接判断结果是否符合预期
if result != 3 {
t.Errorf("add(1,2)结果错误，预期为3，实际为%d", result)
}
result2 := add(-1, 5)
if result2 != 4 {
t.Fatalf("add(-1,5)结果错误，预期为4，实际为%d", result2)
}
}
使用第三方断言库
如果觉得直接写if判断比较繁琐，也可以使用社区成熟的第三方断言库，最常用的就是testify/assert和testify/require，这两个库提供了丰富的断言方法，能简化测试代码的编写。
testify/assert的使用
assert包的方法在断言失败时会记录错误但继续执行测试，和t.Error的行为类似。
package main
import (
"testing"
"github.com/stretchr/testify/assert"
)
func TestAddWithAssert(t *testing.T) {
// 断言结果等于预期值
assert.Equal(t, 3, add(1, 2), "1加2的结果应该是3")
// 断言结果不等于某个值
assert.NotEqual(t, 5, add(1, 2), "1加2的结果不应该等于5")
// 断言结果大于某个值
assert.Greater(t, add(3, 4), 6, "3加4的结果应该大于6")
}
testify/require的使用
require包的方法在断言失败时会立即终止当前测试，和t.Fatalf的行为类似，适合前置条件不满足时就不需要继续执行后续测试的场景。
package main
import (
"testing"
"github.com/stretchr/testify/require"
)
func TestAddWithRequire(t *testing.T) {
// 断言失败会直接终止测试
require.Equal(t, 3, add(1, 2), "1加2的结果必须是3")
// 上面的断言通过才会执行下面的逻辑
require.Greater(t, add(2, 2), 3, "2加2的结果必须大于3")
}
自定义断言函数
如果项目有特定的测试判断逻辑，也可以自己封装断言函数，统一测试结果的判断规则，提升代码的复用性。
package main
import (
"fmt"
"testing"
)
// 自定义相等断言函数
func assertEqual(t *testing.T, expected, actual interface{}, msg string) {
t.Helper() // 标记该函数是测试辅助函数，错误时会指向调用方的代码行
if expected != actual {
t.Errorf("%s: 预期值=%v, 实际值=%v", msg, expected, actual)
}
}
// 自定义错误断言函数
func assertNoError(t *testing.T, err error, msg string) {
t.Helper()
if err != nil {
t.Errorf("%s: 出现错误=%v", msg, err)
}
}
func TestCustomAssert(t *testing.T) {
assertEqual(t, 3, add(1, 2), "自定义断言校验add结果")
assertNoError(t, nil, "校验无错误场景")
}
不同方式的适用场景对比
下面是三种常见测试判断方式的对比，开发者可以根据实际需求选择：
| 判断方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 标准库直接判断 | 无额外依赖，原生支持 | 代码冗余，复杂判断逻辑写起来繁琐 | 简单测试，不希望引入第三方依赖的项目 |
| 第三方断言库 | 方法丰富，代码简洁，可读性强 | 需要引入第三方依赖 | 复杂测试场景，追求测试代码简洁的项目 |
| 自定义断言函数 | 可定制逻辑，代码复用性高 | 需要自己维护代码 | 有统一测试规则，特殊判断逻辑的项目 |
注意事项
- 测试函数中不要使用panic来处理测试失败，panic会导致整个测试进程退出，而不是单个测试失败。
- 使用第三方库时要注意版本兼容性，避免版本冲突问题。
- 自定义断言函数时记得调用
t.Helper()，这样测试失败时错误提示会指向调用断言的地方，而不是断言函数内部。 - 不要过度使用断言，测试代码的核心还是校验业务逻辑的正确性，断言只是实现手段。
Go_testassertiontesting_packagetest_result_judgment修改时间：2026-06-20 13:30:36