Go测试函数必须以Test开头、接收*testing.T参数、命名符合TestXxx规则且文件名为xxx_test.go;t.Error记录错误后继续执行,t.Fatal则立即终止当前测试函数。
Go 的 testing 包本身不支持 setup/teardown 钩子,也不支持参数化测试或子测试的自动分组——这意味着你得手动管理状态、用 t.Run() 显式划分逻辑、靠命名和结构来模拟“测试套件”。
如何写一个最简可运行的测试函数
Go 要求测试函数必须以 Test 开头、接收单个 *testing.T 参数、且放在 _test.go 文件里。文件名和函数名都必须符合约定,否则 go test 直接忽略。
- 文件名必须是
xxx_test.go(不能是test_xxx.go或xxx_test.golang) - 函数签名必须是
func TestXxx(t *testing.T)(Xxx首字母大写,不能带下划线) - 不返回值,不接受额外参数,哪怕只是想传个字符串也会编译失败
示例:
func TestAdd(t *testing.T) {
result := add(2, 3)
if result != 5 {
t.Errorf("expected 5, got %d", result)
}
}
为什么 t.Fatal 和 t.Error 行为差别这么大
t.Error 只记日志并继续执行后续语句;t.Fatal 记日志后立刻终止当前测试函数——但注意,它不会跳出整个测试文件,也不会影响其他测试函数运行。
- 用
t.Fatal适合检查前置条件,比如配置加载失败、临时目录创建失败 - 用
t.Error更适合校验多个断言,避免漏掉后面几个错误 - 误用
t.Fatal在循环里会导致只测第一个元素就退出,常见于遍历测试用例时
反例(容易踩坑):