3、编写可测试的Go代码：单元测试基础、表驱动测试、测试覆盖率

在CI/CD流水线中，自动化测试是质量门禁的核心。Go语言内置了强大的测试工具链，无需第三方框架即可编写高效、可维护的单元测试。本章将系统讲解Go单元测试的三大支柱：基础测试结构、表驱动测试模式以及测试覆盖率分析，帮助你在多环境部署前建立可靠的测试防线。

3.1 Go单元测试基础

Go的测试文件遵循约定：文件名以 _test.go 结尾，测试函数以 Test 开头，参数为 *testing.T。以下是一个针对HTTP处理函数的测试示例。

// handler.go
package handler

import (
    "encoding/json"
    "net/http"
)

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

func GetUser(w http.ResponseWriter, r *http.Request) {
    user := User{ID: 1, Name: "Alice"}
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(user)
}

// handler_test.go
package handler

import (
    "net/http"
    "net/http/httptest"
    "testing"
)

func TestGetUser(t *testing.T) {
    req := httptest.NewRequest(http.MethodGet, "/user", nil)
    rec := httptest.NewRecorder()

    GetUser(rec, req)

    if rec.Code != http.StatusOK {
        t.Errorf("expected status 200, got %d", rec.Code)
    }

    expected := `{"id":1,"name":"Alice"}`
    if rec.Body.String() != expected {
        t.Errorf("expected body %s, got %s", expected, rec.Body.String())
    }
}

3.2 表驱动测试：消除重复，提升可维护性

表驱动测试（Table-Driven Tests）是Go社区推崇的测试模式。它将测试用例组织为结构体切片，每个用例包含输入、预期输出和可选名称，通过循环统一执行。这种方式显著减少重复代码，新增用例只需添加一行数据。

// calculator.go
package calculator

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

func Divide(a, b int) (int, error) {
    if b == 0 {
        return 0, ErrDivisionByZero
    }
    return a / b, nil
}

var ErrDivisionByZero = fmt.Errorf("division by zero")

// calculator_test.go
package calculator

import "testing"

func TestAdd(t *testing.T) {
    tests := []struct {
        name string
        a, b int
        want int
    }{
        {"positive numbers", 2, 3, 5},
        {"negative numbers", -1, -2, -3},
        {"zero", 0, 0, 0},
        {"mixed", -5, 8, 3},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            got := Add(tt.a, tt.b)
            if got != tt.want {
                t.Errorf("Add(%d, %d) = %d, want %d", tt.a, tt.b, got, tt.want)
            }
        })
    }
}

func TestDivide(t *testing.T) {
    tests := []struct {
        name    string
        a, b    int
        want    int
        wantErr bool
    }{
        {"normal division", 10, 2, 5, false},
        {"division by zero", 5, 0, 0, true},
        {"negative division", -9, 3, -3, false},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            got, err := Divide(tt.a, tt.b)
            if (err != nil) != tt.wantErr {
                t.Errorf("Divide(%d, %d) error = %v, wantErr %v", tt.a, tt.b, err, tt.wantErr)
                return
            }
            if got != tt.want {
                t.Errorf("Divide(%d, %d) = %d, want %d", tt.a, tt.b, got, tt.want)
            }
        })
    }
}

3.3 测试覆盖率：量化测试的完整性

Go原生支持覆盖率分析，通过 go test -cover 查看语句覆盖率百分比，-coverprofile 输出详细文件供可视化分析。覆盖率是质量门禁的重要指标，但需避免盲目追求100%——核心逻辑和边界条件比数字更重要。

3.4 测试组织结构与运行策略

在CI/CD流水线中，测试需要分层执行。下表展示了不同阶段的测试策略。

# 在CI中常用的测试命令组合
go test ./... -v -cover -coverprofile=coverage.out -count=1

# 生成HTML报告（可选，用于归档）
go tool cover -html=coverage.out -o coverage.html

# 检查覆盖率是否达到阈值（示例：80%）
go tool cover -func=coverage.out | grep total | awk '{print $3}' | sed 's/%//' | xargs -I {} bash -c 'if [ {} -lt 80 ]; then echo "Coverage {}% below 80%"; exit 1; fi'

3.5 内联SVG：Go单元测试执行流程

3.6 实战建议与常见模式

• 测试金字塔原则：单元测试占比70%以上，集成测试20%，端到端测试10%。Go单元测试执行速度快，适合在每次提交时全量运行。
• Mock外部依赖：对于数据库、HTTP客户端等外部服务，使用接口抽象 + 测试替身（stub/mock），避免测试依赖真实环境。
• 测试文件组织：每个包一个 _test.go 文件，大型包可按功能拆分为多个测试文件（如 handler_test.go、service_test.go）。
• 持续集成集成：在CI脚本中执行 go test ./... -race -coverprofile=coverage.out，-race 检测数据竞态，-coverprofile 输出覆盖率数据。