Golang单元测试编写教程及gotest使用指南

golang学习网今天将给大家带来《Golang单元测试怎么写\_Go test入门教程》，感兴趣的朋友请继续看下去吧！以下内容将会涉及到等等知识点，如果你是正在学习Golang或者已经是大佬级别了，都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家！

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

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

写一个最简单的测试函数

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

add.go

package main

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

对应写测试文件（注意文件名）：

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 社区推荐用结构体切片组织测试数据，更清晰也更易维护：

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 的测试不是炫技，而是快速建立信心：改代码前先看测试绿不绿，加功能后补上对应测试。写得越早，后期越省心。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang单元测试编写教程及gotest使用指南》文章吧，也可关注golang学习网公众号了解相关技术文章。