Golang中对结构体方法单元测试需用testing包编写TestXxx函数,构造实例调用方法并比对结果,测试文件名须为*_test.go且同包,推荐用t.Run组织子测试覆盖边界情况。

在 Golang 中对结构体方法进行单元测试,核心是通过 testing 包编写测试函数,验证方法的行为是否符合预期。关键在于构造结构体实例、调用其方法,并比对输出结果。
准备被测结构体和方法
假设我们有一个表示用户信息的结构体 User,并定义了方法 GetFullName 和 IsAdult:
<span style="color:blue;">package</span> main
<span style="color:blue;">type</span> User <span style="color:blue;">struct</span> {
FirstName <span style="color:blue;">string</span>
LastName <span style="color:blue;">string</span>
Age <span style="color:blue;">int</span>
}
<span style="color:blue;">func</span> (u *User) GetFullName() <span style="color:blue;">string</span> {
<span style="color:blue;">return</span> u.FirstName + " " + u.LastName
}
<span style="color:blue;">func</span> (u *User) IsAdult() <span style="color:blue;">bool</span> {
<span style="color:blue;">return</span> u.Age >= 18
}
编写单元测试文件
创建同名目录下的测试文件,例如 user_test.go,使用 testing 包进行测试。
<span style="color:blue;">package</span> main
<span style="color:blue;">import</span> (
<span style="color:#a31515;">"testing"</span>
)
<span style="color:blue;">func</span> TestUser_GetFullName(t *testing.T) {
user := &User{
FirstName: <span style="color:#a31515;">"John"</span>,
LastName: <span style="color:#a31515;">"Doe"</span>,
}
fullName := user.GetFullName()
<span style="color:blue;">if</span> fullName != <span style="color:#a31515;">"John Doe"</span> {
t.Errorf(<span style="color:#a31515;">"期望 'John Doe',实际 '%s'"</span>, fullName)
}
}
<span style="color:blue;">func</span> TestUser_IsAdult(t *testing.T) {
tests := []<span style="color:blue;">struct</span> {
name <span style="color:blue;">string</span>
age <span style="color:blue;">int</span>
want <span style="color:blue;">bool</span>
}{
{<span style="color:#a31515;">"成年人"</span>, 20, <span style="color:blue;">true</span>},
{<span style="color:#a31515;">"未成年人"</span>, 16, <span style="color:blue;">false</span>},
{<span style="color:#a31515;">"刚好成年"</span>, 18, <span style="color:blue;">true</span>},
}
<span style="color:blue;">for</span> _, tt := <span style="color:blue;">range</span> tests {
t.Run(tt.name, <span style="color:blue;">func</span>(t *testing.T) {
u := &User{Age: tt.age}
<span style="color:blue;">if</span> got := u.IsAdult(); got != tt.want {
t.Errorf(<span style="color:#a31515;">"IsAdult() = %v, want %v"</span>, got, tt.want)
}
})
}
}
运行测试
在项目根目录执行命令:
立即学习“go语言免费学习笔记(深入)”;
go test -v
输出会显示每个测试用例的执行情况。如果所有断言通过,测试成功。
关键点总结:- 测试文件命名应为
*_test.go,且与原文件在同一包中 - 测试函数以
TestXxx开头,参数为*testing.T - 使用
t.Run实现子测试,便于区分多个场景 - 通过构造结构体实例调用方法,验证返回值或状态变化
- 避免测试私有字段或实现细节,只关注公共行为










