Golang单元测试怎么写\_Go test入门教程

Go语言的单元测试以简洁高效著称，无需复杂框架，仅需遵循_test.go文件命名、Test开头函数名和*testing.T参数三大约定，即可用内置go test命令快速运行；文章手把手教你从最基础的断言测试，到推荐的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单元测试怎么写\_Go test入门教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！