当前位置：首页 > 文章列表 > Golang > Go教程 > Golang测试t.Run用法详解

Golang测试t.Run用法详解

2026-02-02 13:00:46 0浏览收藏

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Golang测试中t.Run使用方法详解》，聊聊，我们一起来看看吧！

t.Run用于在单个测试函数中划分独立子测试，提升失败定位精度与输出可读性，支持嵌套分组、独立计时和失败标记。

Golang如何在测试中使用t.Run

为什么测试里要用 `t.Run`

因为单个测试函数里混着多个逻辑分支时，t.Run 能让失败定位更准、输出更清晰。不加它，一旦某个断言失败，整个测试就中断，后面用例根本跑不到；加了它，每个子测试独立运行、独立计时、独立标记失败，还能嵌套分组。

`t.Run` 的基本写法和参数含义

签名是 func (t *T) Run(name string, f func(t *T)) bool，第一个参数是子测试名（建议用可读字符串，别用变量拼接），第二个是实际执行的函数。注意：这个函数必须接收且只接收一个 *testing.T 参数，不能多也不能少。

func TestCalculate(t *testing.T) {
    t.Run("positive numbers", func(t *testing.T) {
        got := Add(2, 3)
        if got != 5 {
            t.Errorf("expected 5, got %d", got)
        }
    })

    t.Run("negative numbers", func(t *testing.T) {
        got := Add(-1, -2)
        if got != -3 {
            t.Errorf("expected -3, got %d", got)
        }
    })
}

子测试名里别含空格或斜杠（某些 IDE 或 go test -run 过滤会出问题）
子测试内部不能再调 t.Fatal —— 它会让当前子测试立刻终止，但不影响其他子测试运行
如果想让某个子测试跳过，用 t.Skip()，不是 return

嵌套 `t.Run` 和表格驱动测试怎么配合

最常用场景就是表格驱动测试（table-driven tests）。外层 t.Run 按用例分组，内层按输入组合展开，结构干净，错误信息带上下文。

func TestParseURL(t *testing.T) {
    tests := []struct {
        name     string
        input    string
        wantHost string
        wantErr  bool
    }{
        {"empty string", "", "", true},
        {"valid http", "http://example.com", "example.com", false},
        {"valid https", "https://api.test:8080/path", "api.test", false},
    }

    for _, tt := range tests {
        tt := tt // 必须复制，否则闭包里用的是循环末尾的值
        t.Run(tt.name, func(t *testing.T) {
            u, err := url.Parse(tt.input)
            if (err != nil) != tt.wantErr {
                t.Fatalf("Parse() error = %v, wantErr %v", err, tt.wantErr)
            }
            if !tt.wantErr && u.Host != tt.wantHost {
                t.Errorf("Parse().Host = %v, want %v", u.Host, tt.wantHost)
            }
        })
    }
}