subtest是Go中通过t.Run()创建的子测试，用于分组测试用例、提升可读性和调试效率。它支持并行执行、共享setup、动态命名和单独运行，常与表格驱动结合，使测试结构清晰、易扩展。

在 Go 语言的测试中，使用 subtest（子测试）可以将一个测试函数拆分为多个逻辑子测试，尤其适合对同一函数的不同输入场景进行分组测试。它不仅让测试结构更清晰，还能单独运行某个子测试，提升调试效率。

什么是 subtest

subtest 是 *testing.T 类型提供的方法，通过 t.Run() 创建。每个子测试独立运行，有自己的名称和生命周期，支持并行执行、条件跳过和错误报告。

常见用途包括：

• 对同一函数测试多种输入组合
• 按功能模块或业务场景分组测试用例
• 复用 setup/teardown 逻辑

基本用法：t.Run()

下面是一个使用 subtest 测试字符串比较函数的例子：

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

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

func TestEqual(t *testing.T) {
  t.Run("same strings", func(t *testing.T) {
    if !strings.Equal("hello", "hello") {
      t.Error("expected hello == hello")
    }
  })

  t.Run("different strings", func(t *testing.T) {
    if strings.Equal("hello", "world") {
      t.Error("expected hello != world")
    }
  })
}

运行结果会显示为：

--- PASS: TestEqual (0.00s)
    --- PASS: TestEqual/same_strings (0.00s)
    --- PASS: TestEqual/different_strings (0.00s)

使用表格驱动 + subtest 分组

结合表格驱动测试（table-driven test）可以让用例管理更高效。每个表项生成一个 subtest，便于定位失败用例。

func TestValidateEmail(t *testing.T) {
  tests := []struct {
    name  string
    email string
    valid bool
  }{
    {"valid gmail", "user@gmail.com", true},
    {"invalid domain", "user@bad-domain", false},
    {"empty", "", false},
  }

  for _, tt := range tests {
    t.Run(tt.name, func(t *testing.T) {
      result := ValidateEmail(tt.email)
      if result != tt.valid {
        t.Errorf("expected %v, got %v", tt.valid, result)
      }
    })
  }
}

这种写法清晰、易扩展，每个测试用例独立命名，输出信息明确。

subtest 的实用技巧

利用 subtest 可以实现一些高级控制：

• 并行执行：在子测试中调用 t.Parallel()，可让多个 subtest 并发运行，加快测试速度
• 共享 setup：在外部测试函数中执行公共初始化，如数据库连接、配置加载
• 动态命名：subtest 名称支持斜杠 "/"，自动形成层级结构，例如 "MySQL/insert" 和 "PostgreSQL/insert"
• 单独运行：使用命令 go test -run TestName/SubTestName 运行指定子测试

基本上就这些。subtest 让 Go 的测试更具组织性和可维护性，特别适合复杂逻辑或多场景验证。合理使用，能让测试代码更干净、调试更高效。