如何使用Golang编写基础单元测试_Golang Go test单元测试入门说明

2次阅读

go单元测试简洁高效,只需_test.go文件、Test开头函数和*testing.T参数;支持table-driven批量测试、错误/panic验证及接口mock,强调快速建立代码信心。

如何使用Golang编写基础单元测试_Golang Go test单元测试入门说明

Go 语言的单元测试非常简洁直接,不需要额外框架,只要遵循命名和目录约定,用内置的 go test 命令就能跑起来。核心就三点:测试文件名以 _test.go 结尾、测试函数名以 Test 开头、函数签名必须是 func(t *testing.T)

写一个最简单的测试函数

假设你有一个计算两个整数之和的函数:

add.go

package main  func Add(a, b int) int {     return a + b }

对应写测试文件(注意文件名):

立即学习go语言免费学习笔记(深入)”;

add_test.go

package main  import "testing"  func TestAdd(t *testing.T) {     result := Add(2, 3)     if result != 5 {         t.Errorf("expected 5, got %d", result)     } }

在项目根目录运行:

go test

看到 ok your-module-name 0.001s 就表示通过了。加 -v 参数可以看详细输出:

go test -v

用 table-driven 方式批量测多个用例

手动写一 if 容易重复,Go 社区推荐用结构体切片组织测试数据,更清晰也更易维护:

如何使用Golang编写基础单元测试_Golang Go test单元测试入门说明

AI Code Reviewer

AI自动审核代码

如何使用Golang编写基础单元测试_Golang Go test单元测试入门说明 112

查看详情 如何使用Golang编写基础单元测试_Golang Go test单元测试入门说明

func TestAdd(t *testing.T) {     tests := []struct {         name     string         a, b     int         expected int     }{         {"positive", 2, 3, 5},         {"negative", -1, -1, -2},         {"zero", 0, 0, 0},     }      for _, tt := range tests {         t.Run(tt.name, func(t *testing.T) {             result := Add(tt.a, tt.b)             if result != tt.expected {                 t.Errorf("got %d, want %d", result, tt.expected)             }         })     } }
  • t.Run 支持子测试,每个用例独立运行,失败时能精准定位到哪个 case
  • 名字字段(name)建议有意义,比如 "Add_with_negative_numbers"
  • 测试数据尽量覆盖边界值:正数、负数、零、溢出临界点(如 math.MaxInt64

测试错误路径和 panic

不仅要测“正常返回”,还要验证函数在异常输入下是否按预期处理错误或 panic:

比如一个除法函数:

func Divide(a, b float64) (float64, error) {     if b == 0 {         return 0, errors.New("division by zero")     }     return a / b, nil }

测试它返回错误的情况:

func TestDivide(t *testing.T) {     _, err := Divide(10, 0)     if err == nil {         t.Error("expected error when dividing by zero")     }     if !strings.Contains(err.Error(), "division by zero") {         t.Error("error message mismatch")     } }

如果函数应该 panic(比如断言参数非空),用 func() {...}() 包裹并配合 recover 捕获:

func TestSomethingPanic(t *testing.T) {     defer func() {         if r := recover(); r == nil {             t.Fatal("expected panic")         }     }()     SomethingThatShouldPanic(nil) }

测试依赖外部资源?用接口 + mock 简单替换

真实项目中常要测 http 调用、数据库操作等。Go 推崇“依赖抽象”,把具体实现抽成接口,测试时换 mock 实现即可:

type Client interface {     Get(url string) ([]byte, error) }  func FetchData(c Client, url string) (string, error) {     data, err := c.Get(url)     return string(data), err }

测试时写个假 client:

type mockClient struct {     resp []byte     err  error }  func (m mockClient) Get(_ string) ([]byte, error) {     return m.resp, m.err }  func TestFetchData(t *testing.T) {     c := mockClient{resp: []byte("hello"), err: nil}     result, err := FetchData(c, "http://example.com")     if err != nil || result != "hello" {         t.Error("unexpected result or error")     } }
  • 不强求用第三方 mock 库,简单场景自己写 mock 类型就够了
  • 重点是让被测函数不绑定具体实现,测试才可控、可重复

基本上就这些。Go 的测试不是炫技,而是快速建立信心:改代码前先看测试绿不绿,加功能后补上对应测试。写得越早,后期越省心。

text=ZqhQzanResources