Go中推荐用table-driven方式测试结构体方法，即定义含输入、期望输出及错误的结构体切片，循环调用并用t.Run执行子测试，注意闭包变量捕获问题及指针接收者的副作用处理。

在 Go 中，用 table-driven 方式测试结构体方法是最清晰、可维护性最强的做法。核心是把输入、预期输出、甚至预期错误组织成结构体切片，再用循环统一断言，避免重复代码。

定义测试数据表（test table）

为每个要验证的结构体方法准备一组测试用例，每个用例包含：调用该方法所需的输入（如接收者状态、参数）、期望返回值、期望错误（如有）。推荐用匿名结构体或自定义类型提升可读性：

例如，对一个 User 结构体的 FullName() 方法：

tests := []struct {
    name     string
    user     User
    want     string
}{
    {"empty first and last", User{}, ""},
    {"normal case", User{FirstName: "Alice", LastName: "Smith"}, "Alice Smith"},
    {"only first name", User{FirstName: "Bob"}, "Bob"},
}

在循环中调用并断言

遍历测试表，对每个用例调用目标方法，并用 require.Equal 或 assert.Equal（需引入 github.com/stretchr/testify）比较结果。用 t.Run 包裹每个子测试，便于定位失败用例：

Evez Github Manager

在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。

下载

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

for _, tt := range tests {
    tt := tt // 防止闭包中变量复用
    t.Run(tt.name, func(t *testing.T) {
        got := tt.user.FullName()
        require.Equal(t, tt.want, got)
    })
}

注意：必须写 tt := tt，否则所有子测试会共享最后一个 tt 值。

处理带错误返回的方法

若方法返回 (result T, err error)，测试表中应增加 wantErr bool 字段，并用 require.Error / require.NoError 判断错误存在性；必要时再检查错误内容：

tests := []struct {
    name     string
    input    int
    want     string
    wantErr  bool
}{
    {"valid", 42, "ok", false},
    {"invalid", -1, "", true},
}

for _, tt := range tests {
    tt := tt
    t.Run(tt.name, func(t *testing.T) {
        got, err := someStruct.Process(tt.input)
        if tt.wantErr {
            require.Error(t, err)
            return
        }
        require.NoError(t, err)
        require.Equal(t, tt.want, got)
    })
}

覆盖接收者指针与值语义差异

如果方法有指针接收者且会修改结构体字段，测试时需注意是否影响后续用例。建议每个用例使用独立实例，或显式重置：

• 用字面量创建新结构体（推荐）： User{...}
• 避免在循环中复用同一变量地址
• 若测试副作用（如计数器递增），可在每个 t.Run 内部初始化