17370845950

Go 1.22+ 支持原生 -failfast 参数实现快速失败，首个 TestXXX 失败即终止；旧版本需通过 TestMain + 全局标记 + os.Exit 模拟；-failfast 不兼容竞态检测，且不影响子测试内部流程。

Go 的测试框架本身不内置“fail-fast”（快速失败）模式，但可以通过命令行参数和简单约定实现类似效果：一旦某个测试用例失败，立即停止后续执行。

使用 -failfast 参数（Go 1.22+）

从 Go 1.22 开始，go test 原生支持 -failfast 标志：

• 它会让测试在**第一个失败的测试函数（TestXXX）** 后立刻退出，不再运行其余测试
• 仅对顶层测试函数生效，不影响子测试（t.Run）内部的失败行为
• 使用方式：go test -failfast 或 go test -failfast -v
• 注意：该标志不兼容 -race、-msan 等竞态检测工具（会自动禁用 failfast）

兼容旧版本 Go 的手动 failfast 方式

若使用 Go 1.21 或更早版本，可借助 os.Exit(1) 在失败时强制终止：

• 在测试函数中判断关键断言失败后，调用 t.FailNow() —— 它会终止当前测试函数，但不会停掉整个测试套件
• 如需真正“全局快速失败”，可在测试主函数中设置一个全局标记，并在 TestMain 中检查：

var failed = false
func TestMain(m *testing.M) {
    code := m.Run()
    if failed {
        os.Exit(1)
    }
    os.Exit(code)
}
func TestA(t *testing.T) {
if !someCondition() {
failed = true
t.Fatal("critical failure, abort all")
}
}

结合子测试（t.Run）的注意事项

子测试默认并行或顺序执行，但 -failfast 不会中断已启动的子测试：

• 如果想让某个子测试失败时跳过同级其余子测试，需手动控制流程
• 例如在循环中运行子测试时，检查外部失败标记再决定是否继续
• 避免在子测试里直接 os.Exit，否则会绕过测试框架的清理逻辑

实际建议与权衡

failfast 适合开发调试阶段快速定位首个问题，但不适合 CI 环境：

• CI 中建议关闭 failfast（默认行为），以便一次性获取全部失败项，提高排查效率
• 本地开发可 alias：alias goft='go test -failfast -v'
• 注意：failfast 不影响测试覆盖率统计（-cover），但因提前退出，覆盖率结果可能不完整

基本上就这些。不复杂但容易忽略版本差异和子测试边界。