golang-testing Skill 多维度简评

类别:测试 / Go 最佳实践 仓库:affaan-m/everything-claude-code 维护者:Affaan Mustafa / ECC 社区 引用:CSDN Skills 配置 · cnblogs ECC 详解 · Golang Testing Book

一、核心定位与价值

Go 标准库 testing 包功能极简但强大——但80% 的 Go 开发者只用了 20% 的能力。golang-testing Skill 强制 Claude 生成 idiomatic Go 测试,涵盖:

• 表驱动测试(Table-Driven Tests)
• 子测试(Sub-tests)
• Testify 断言
• Mock 与 Stub
• Fuzzing(Go 1.18+)
• 覆盖率分析
• 基准测试(Benchmarks)
• Race 检测

关键洞见:Go 测试哲学——“A little copying is better than a little dependency”(一点点复制胜过一点点依赖)。优先用 stdlib,慎用第三方。

适用场景

• 写新 Go 函数 / 包的测试
• 提升测试覆盖率
• 写 fuzzing 测试
• 优化测试速度
• 集成到 CI

不适用场景

• 不用 Go
• 一次性脚本
• 已经 100% 覆盖

二、核心测试模式

2.1 表驱动测试(最重要)

来源:Go Testing 官方文档

// 标准表驱动测试模板
func TestAdd(t *testing.T) {
    tests := []struct {
        name     string
        a, b     int
        expected int
    }{
        {"正数", 1, 2, 3},
        {"负数", -1, -2, -3},
        {"零", 0, 0, 0},
        {"大数", 1e9, 2e9, 3e9},
        {"溢出边界", math.MaxInt - 1, 1, math.MaxInt},
    }

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

优势:

• 一个测试函数覆盖 N 个 case
• 新增 case 只需加一行
• t.Run 输出清晰的子测试名
• 失败的 case 单独显示

2.2 Sub-tests 嵌套

func TestUser(t *testing.T) {
    t.Run("Create", func(t *testing.T) {
        t.Run("valid", func(t *testing.T) { /* ... */ })
        t.Run("duplicate", func(t *testing.T) { /* ... */ })
    })
    t.Run("Update", func(t *testing.T) {
        t.Run("valid", func(t *testing.T) { /* ... */ })
    })
    t.Run("Delete", func(t *testing.T) { /* ... */ })
}

运行:

go test -run "TestUser/Create/valid"
go test -run "TestUser/Delete"

2.3 Testify 断言(更易读)

import (
    "github.com/stretchr/testify/assert"
    "github.com/stretchr/testify/require"
)

func TestAdd(t *testing.T) {
    assert.Equal(t, 3, Add(1, 2))
    assert.NotNil(t, obj)
    assert.NoError(t, err)
    assert.Error(t, err, "expected error")

    // require: 失败立即终止后续
    require.NotNil(t, db)
    require.NoError(t, db.Connect())
    // 后续假设 db 已连接
}

区别:

• assert.*:失败继续,记录错误
• require.*:失败立即终止 t

2.4 Mock 与 Stub

// 用 stdlib interface
type UserStore interface {
    Find(ctx context.Context, id string) (*User, error)
}

// Mock 实现
type mockUserStore struct {
    findFunc func(ctx context.Context, id string) (*User, error)
}

func (m *mockUserStore) Find(ctx context.Context, id string) (*User, error) {
    return m.findFunc(ctx, id)
}

// 测试
func TestUserService_GetUser(t *testing.T) {
    store := &mockUserStore{
        findFunc: func(ctx context.Context, id string) (*User, error) {
            if id == "user-1" {
                return &User{ID: "user-1", Name: "Alice"}, nil
            }
            return nil, ErrNotFound
        },
    }
    svc := NewUserService(store)

    user, err := svc.GetUser(context.Background(), "user-1")
    require.NoError(t, err)
    assert.Equal(t, "Alice", user.Name)
}

更简单:用 gomock 或 mockery 自动生成。

2.5 Fuzzing(Go 1.18+)

func FuzzReverse(f *testing.F) {
    // 种子语料
    f.Add("hello")
    f.Add("world")
    f.Add("")
    f.Add("12345")

    f.Fuzz(func(t *testing.T, s string) {
        rev := Reverse(s)
        revRev := Reverse(rev)
        if revRev != s {
            t.Errorf("Reverse(Reverse(%q)) = %q, want %q", s, revRev, s)
        }
    })
}

运行:

# 30 秒 fuzz
go test -fuzz=FuzzReverse -fuzztime=30s

# 只在 corpus 上跑(单元测试)
go test -run=FuzzReverse

2.6 基准测试(Benchmark)

func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Add(i, i+1)
    }
}

// 带子测试
func BenchmarkAddSizes(b *testing.B) {
    sizes := []int{10, 100, 1000, 10000}
    for _, size := range sizes {
        b.Run(fmt.Sprintf("size=%d", size), func(b *testing.B) {
            data := make([]int, size)
            b.ResetTimer()
            for i := 0; i < b.N; i++ {
                _ = process(data)
            }
        })
    }
}

运行:

go test -bench=.
go test -bench=BenchmarkAdd -benchmem  # 显示内存
go test -bench=. -cpuprofile=cpu.prof  # 生成 profile
go tool pprof cpu.prof

2.7 Race Detector

# 检测数据竞争
go test -race ./...

真实价值:80% 的 Go 并发 bug 是 race condition,-race 在测试时捕获。

2.8 覆盖率

# 基本覆盖率
go test -cover ./...

# 输出每个函数的覆盖率
go test -coverprofile=cover.out ./...
go tool cover -func=cover.out

# HTML 可视化
go tool cover -html=cover.out -o cover.html

目标:

• 业务代码 ≥ 80%
• 关键路径(支付 / 安全)≥ 95%
• 测试本身的代码 100% 覆盖

2.9 t.Cleanup(Go 1.14+)

func TestWithCleanup(t *testing.T) {
    db := setupDB()
    t.Cleanup(func() {
        db.Close()  // 测试结束自动调用
    })
    // ...
}

比 defer 更灵活——支持子测试。

2.10 t.TempDir(Go 1.15+)

func TestWithFile(t *testing.T) {
    dir := t.TempDir()  // 自动清理
    file := filepath.Join(dir, "test.txt")
    err := os.WriteFile(file, []byte("hello"), 0644)
    // 测试结束 dir 自动删除
}

三、完整测试套件结构

myproject/
├── internal/
│   └── user/
│       ├── user.go
│       ├── user_test.go       # 单元测试
│       └── user_integration_test.go  # 集成测试
├── test/
│   ├── integration/           # 跨包集成测试
│   ├── e2e/                   # 端到端测试
│   └── testdata/              # 测试数据(fixture)
├── Makefile                    # test / test-race / bench 命令
└── .github/workflows/ci.yml   # CI 集成

四、CI 集成

4.1 GitHub Actions

name: Tests
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-go@v5
        with:
          go-version: '1.22'
          cache: true

      - name: Run tests with race
        run: go test -race -coverprofile=cover.out -covermode=atomic ./...

      - name: Upload coverage
        uses: codecov/codecov-action@v4
        with:
          file: cover.out
          fail_ci_if_error: true
          threshold: 80%

      - name: Run benchmarks
        run: go test -bench=. -benchmem ./... | tee bench.txt

4.2 Makefile

.PHONY: test test-race cover bench

test:
	go test ./...

test-race:
	go test -race ./...

cover:
	go test -coverprofile=cover.out ./...
	go tool cover -html=cover.out -o cover.html

bench:
	go test -bench=. -benchmem ./...

lint:
	golangci-lint run

fuzz:
	go test -fuzz=. -fuzztime=60s

五、5 大反模式

5.1 不写测试

// ❌ INHUMAN
func Add(a, b int) int { return a + b }
// (没测试)

Skill 强制:每个函数都要有测试,TDD 红-绿-重构。

5.2 测试相互依赖

// ❌ BAD
var sharedUser *User

func TestA(t *testing.T) {
    sharedUser = createUser()
}

func TestB(t *testing.T) {
    // 依赖 TestA 先跑
    fmt.Println(sharedUser.Name)
}

解决:每个测试独立创建 fixture。

5.3 断言不具体

// ❌ BAD
if err != nil {
    t.Fatal(err)
}

// ✅ GOOD
require.NoError(t, err, "user creation should succeed")

5.4 时间相关测试

// ❌ 不可靠
time.Sleep(2 * time.Second)
assert.Equal(t, expected, current)

// ✅ 用 mock
clock := clockwork.NewFakeClock()
svc := NewService(clock)
clock.Advance(2 * time.Hour)

5.5 真实数据库 / 网络

// ❌ 慢且不可靠
db := sql.Open("postgres", "real-connection-string")
defer db.Close()

// ✅ 用 sqlmock / dockertest
sqlmock.New(sqlmock.QueryMatcherOption(matcher))

六、Mock 库对比

七、Fuzzing 实战

7.1 用 Go 内置 fuzzing

func FuzzParseURL(f *testing.F) {
    f.Add("https://example.com/path?q=1")
    f.Add("http://localhost:3000")
    f.Add("not a url")

    f.Fuzz(func(t *testing.T, input string) {
        u, err := url.Parse(input)
        if err != nil {
            return  // 接受任何错误
        }
        if u.String() != input && !strings.HasPrefix(input, "http") {
            // 检测 idempotent 性质
        }
    })
}

7.2 Fuzzing 发现过的真实 bug

来源:Go 官方 Fuzzing 介绍

• 标准库 encoding/json 整数解析
• 标准库 net/url 解析边界
• 多个流行 Go 库的 panic

7.3 fuzztime 建议

八、与其他 Skill 配合

完整工作流:

[1] writing-plans(规划)
  ↓
[2] test-driven-development(RED)
  ↓
[3] golang-patterns + golang-testing(写实现 + 测试)
  ↓
[4] verification-before-completion(跑全量测试)
  ↓
[5] CI 自动跑 -race -cover

九、Q&A

Q: 跟 golang-patterns 区别? A: patterns 关注代码风格;testing 关注测试模式。

Q: 必须用 Testify 吗? A: 不。stdlib testing 包够用。Testify 让断言更可读。

Q: Fuzzing 值得吗? A: 解析 / 序列化 / 输入处理代码,值得;CRUD 简单逻辑,不必。

Q: 100% 覆盖率必要吗? A: 80% 是工程甜点。100% 是合规要求(如医疗 / 金融)。

Q: 跟 testify suite 关系? A: testify/suite 提供 setUp/tearDown,适合大测试套件。

Q: 性能测试跟 fuzz 区别? A: 性能测试测速度;fuzz 测正确性 + 边界。

Q: 中文支持? A: 完美。

十、Prompt 模板

模板 1:生成测试

用 golang-testing Skill 为 user_service.go 生成测试:
- 表驱动测试
- 子测试 t.Run
- 覆盖率 ≥ 85%
- 包含 race 检测
- 用 stdlib testing(不引入 testify)

模板 2:补全覆盖率

当前 user_repository.go 覆盖率 60%,用 golang-testing 补到 90%:
- 重点覆盖:错误路径、边界条件
- 用表驱动测试
- 用 mock 模拟外部依赖

模板 3:Fuzzing 测试

为我的 JSON parser 写 fuzzing 测试:
- 输入: 任意 string
- 不变量: round-trip 正确(json.Marshal(json.Unmarshal(x)) == x)
- 跑 5 分钟
- 找到 crash 自动保存 corpus

十一、真实踩坑案例

案例 1:测试慢

现象:go test 跑 5 分钟。 根因:每测试都连真实 DB。 解决:用 sqlmock 单元测 + dockertest 集成测。

案例 2:Flaky 测试

现象:测试偶发失败。 根因:依赖 time.Sleep / 全局状态。 解决:用 mock clock + 独立 fixture。

案例 3:覆盖率高但漏 bug

现象:覆盖率 90%,线上还有 bug。 根因:只覆盖 happy path,漏错误路径。 解决:错误注入测试 + 边界测试。

案例 4:Race condition 漏报

现象:测试都过,生产偶发崩溃。 根因:没用 -race。 解决:CI 强制 go test -race。

案例 5:Fuzzing 报 nil pointer

现象:Fuzzing 找到 nil pointer dereference。 根因:没处理空字符串输入。 解决:加 nil check + 边界测试。

案例 6:Test fixture 复杂

现象:测试需要 mock 5 个依赖。 根因:函数太大,违反 SRP。 解决:重构 + 用 testify/mock。

案例 7:Mock 跟实现不一致

现象:Mock 返回跟真实代码不一样。 根因:Mock 是手写的,实现变了 Mock 没变。 解决:用 mockery 自动生成 mock。

案例 8:覆盖率假象

现象:覆盖率 100% 但 panic。 根因:每行都执行,但没断言返回值。 解决:必须 assert + mutation testing。

案例 9:测试污染

现象:测试单独过,一起跑 fail。 根因:全局状态污染。 解决:每个 test 独立 setup + t.Cleanup。

案例 10:Benchmark 结果不可重现

现象:benchmark 结果抖动大。 根因:CPU 频率、GC 暂停、其他进程干扰。 解决:-benchtime=10s + -count=5 取中位数 + 关其他进程。

十二、真实战绩

十三、安装

# Claude Code
/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code
cp -r everything-claude-code/rules/common ~/.claude/rules/
cp -r everything-claude-code/rules/golang ~/.claude/rules/

# 测试工具
go install github.com/stretchr/testify/...@latest
go install github.com/golang/mock/mockgen@latest
go install github.com/vektra/mockery/v2@latest

# 通用
npx skills add affaan-m/everything-claude-code --skill golang-testing

十四、总结

核心价值:

• Go idiomatic 测试模式
• 表驱动 + 子测试黄金组合
• Fuzzing 找边界 bug
• Race detector 防并发 bug
• 完整 CI 集成

适用人群:

• Go 后端开发者
• 微服务架构师
• 云原生项目
• 用 AI 辅助写测试的团队

投入产出比:⭐⭐⭐⭐(4/5)—— Go 团队必装。

何时不要用:

• 不用 Go
• 一次性脚本
• 极小项目(< 100 行)

参考链接:

• everything-claude-code GitHub
• CSDN: Claude Code Skills 配置
• Go 官方 testing 包
• Go Fuzzing 官方介绍
• Testify GitHub
• Golang Blog: Testable Examples
• 配套:golang-patterns | superpowers/TDD | verification-before-completion