Golang单元测试如何编写-Golang-PHP中文网

go单元测试由语言原生支持，需严格遵循_test.go命名、testxxx函数签名；应隔离外部依赖、使用接口抽象和mock；推荐表格驱动+子测试+t.run组织，并注意并发安全与清理。

golang单元测试如何编写

Go 的单元测试不是靠框架驱动，而是语言原生支持——go test 命令和 *testing.T 类型就是全部基础。写法简单，但容易忽略边界、依赖隔离和测试可维护性。

测试文件命名和函数签名必须严格匹配

Go 要求测试文件名以 _test.go 结尾，且测试函数必须是 func TestXxx(*testing.T) 形式，其中 Xxx 首字母大写。不满足任一条件，go test 就会直接跳过。

calculator_test.go ✅；calculator_tests.go ❌（不会被识别）
func TestAdd(t *testing.T) ✅；func testAdd(t *testing.T) ❌（小写开头不运行）
func TestAdd(t *testing.B) ❌（类型错，这是基准测试用的）

避免在测试中直接调用真实外部依赖

比如数据库、HTTP 客户端、时间相关操作。硬编码调用会让测试变慢、不稳定、难以复现。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

用接口抽象依赖：把 *sql.DB 换成 DBExecutor 接口，测试时传入 mock 实现
时间敏感逻辑用 time.Now 的封装，例如 clock.Now()，测试时注入固定时间的 FixedClock
HTTP 请求不要直连 http.DefaultClient，改用可替换的 http.Client 字段或参数

使用 `t.Run` 组织子测试并提前失败

单个测试函数里验证多个输入场景时，用 t.Run 不仅能分组输出、独立标记失败，还能配合 t.Fatal 实现“某个子测试挂了不影响其他子测试运行”。

func TestParseURL(t *testing.T) {
    tests := []struct {
        name     string
        input    string
        wantErr  bool
    }{
        {"empty", "", true},
        {"valid", "https://example.com", false},
    }
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            _, err := url.Parse(tt.input)
            if (err != nil) != tt.wantErr {
                t.Fatalf("Parse() error = %v, wantErr %v", err, tt.wantErr)
            }
        })
    }
}