t.Run用于Go测试中创建子测试，提升用例组织性与可读性。通过示例可见，它支持分组命名、独立运行及清晰输出，结合表驱动更高效。

在Go语言中，t.Run 是 *testing.T 类型的一个方法，用于创建子测试（subtests）。它让测试更具结构性，便于组织用例、隔离执行以及更清晰地输出结果。下面是一个使用 t.Run 实现子测试的实用示例。

基本结构：使用 t.Run 分组测试用例

假设我们有一个简单的函数，用于判断一个整数是否为偶数：

// even.go
package main

func IsEven(n int) bool {
  return n%2 == 0
}

接下来编写测试文件，并使用 t.Run 来组织多个测试用例：

// even_test.go
package main

import "testing"

func TestIsEven(t *testing.T) {
  t.Run("even number", func(t *testing.T) {
    if !IsEven(4) {
      t.Error("expected 4 to be even")
    }
  })

  t.Run("odd number", func(t *testing.T) {
    if IsEven(3) {
      t.Error("expected 3 not to be even")
    }
  })

  t.Run("zero is even", func(t *testing.T) {
    if !IsEven(0) {
      t.Error("expected 0 to be even")
    }
  })
}

运行测试并查看输出

在项目目录下运行：

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

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

go test -v

输出类似：

=== RUN TestIsEven
   === RUN TestIsEven/even_number
   === RUN TestIsEven/odd_number
   === RUN TestIsEven/zero_is_even
--- PASS: TestIsEven (0.00s)
    --- PASS: TestIsEven/even_number (0.00s)
    --- PASS: TestIsEven/odd_number (0.00s)
    --- PASS: TestIsEven/zero_is_even (0.00s)
PASS
ok  example.com/even  0.001s

可以看到每个子测试都有独立名称和运行结果，层级清晰。

优势与使用建议

• 结构清晰：通过命名子测试，可以清楚知道哪个具体场景失败
• 可单独运行：支持使用 -run=TestName/SubName 运行特定子测试，例如：
  go test -v -run=TestIsEven/odd
• 便于参数化：结合表驱动测试更高效

下面是结合表驱动的写法示例：

func TestIsEven_TableDriven(t *testing.T) {
  tests := []struct {
    name string
    input int
    want bool
  }{
    {"even number", 4, true},
    {"odd number", 3, false},
    {"zero", 0, true},
  } 

  for _, tt := range tests {
    t.Run(tt.name, func(t *testing.T) {
      if got := IsEven(tt.input); got != tt.want {
        t.Errorf("IsEven(%d) = %v; want %v", tt.input, got, tt.want)
      }
    })
  }
}

基本上就这些。t.Run 让测试更模块化，推荐在编写测试时积极使用。