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实现子测试,便于区分多个场景 - 通过构造结构体实例调用方法,验证返回值或状态变化
- 避免测试私有字段或实现细节,只关注公共行为
基本上就这些。写好结构体方法的测试,重点是覆盖常见输入和边界情况,确保逻辑正确。