Golang如何使用t.Run进行子测试-Golang-PHP中文网

Golang如何使用t.Run进行子测试

P粉602998670

发布： 2025-10-08 11:46:01

原创

962人浏览过

t.Run用于创建子测试，可组织测试逻辑、独立运行用例、隔离上下文并清晰展示结果。示例：TestAdd中分“正数相加”和“负数相加”两个子测试。优势包括支持go test -run过滤执行、共享setup、并行运行t.Parallel()及清晰错误定位。常与表格驱动结合，如TestDivide遍历用例并为每个命名运行子测试。注意循环中变量捕获、避免goroutine误用外部t，t.Parallel()应置于t.Run内。

golang如何使用t.run进行子测试

在Go语言中，t.Run 是 *testing.T 提供的一个方法，用于创建子测试（subtests）。它不仅能帮助你组织测试逻辑，还能实现更灵活的测试控制，比如独立运行某个测试用例、隔离测试上下文以及更好地展示测试结果。下面详细介绍如何使用 t.Run 进行子测试。

使用 t.Run 创建子测试

通过 t.Run，你可以将一个测试函数拆分为多个命名的子测试。每个子测试都有自己的名称和独立的执行环境。

基本语法如下：

func TestXXX(t *testing.T) {
  t.Run("子测试名称", func(t *testing.T) {
    // 测试逻辑
  })
}

示例：

立即学习“go语言免费学习笔记（深入）”；

func TestAdd(t *testing.T) {
  t.Run("正数相加", func(t *testing.T) {
    if Add(2, 3) != 5 {
      t.Error("期望 2+3=5")
    }
  })

  t.Run("负数相加", func(t *testing.T) {
    if Add(-1, -1) != -2 {
      t.Error("期望 -1 + -1 = -2")
    }
  })
}

子测试的优势与用途

t.Run 不只是一个结构化工具，它还带来以下几个实用特性：

白瓜面试

白瓜面试 - AI面试助手,辅助笔试面试神器

查看详情

独立运行测试用例：使用命令如 go test -run TestAdd/正数相加 可以只运行匹配的子测试，便于调试。
共享前置逻辑：可以在外层测试中做公共 setup，每个子测试专注于不同场景。
测试作用域隔离：每个子测试有独立的生命周期，t.Parallel() 可以安全地在子测试中调用，实现并行执行。
清晰的输出结构：当测试失败时，日志会明确指出是哪个子测试出错。

结合表格驱动测试使用 t.Run

最常见且推荐的方式是将 t.Run 与表格驱动测试（table-driven tests）结合使用。

func TestDivide(t *testing.T) {
  tests := []struct {
    name string
    a, b int
    expected int
  }{
    {"正数除法", 10, 2, 5},
    {"被除数为零", 0, 5, 0},
  }

  for _, tt := range tests {
    t.Run(tt.name, func(t *testing.T) {
      result := Divide(tt.a, tt.b)
      if result != tt.expected {
        t.Errorf("期望 %d，实际 %d", tt.expected, result)
      }
    })
  }
}

这种写法让测试更加简洁、可扩展，并能清楚看到每个测试用例的名称和结果。