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

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

P粉602998670

发布： 2025-12-16 20:15:35

原创

638人浏览过

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

AI Code Reviewer

AI自动审核代码

112

查看详情

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")
    }
}

登录后复制