Golang Testing

affaan-m/ECC/.kiro/skills/golang-testing

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775无许可证275K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库4天前更新

Go testing best practices including table-driven tests, test helpers, benchmarking, race detection, coverage analysis, and integration testing patterns. Use when writing or improving Go tests.

仅含说明Software Development
AI 生成的概览

提供 Go 测试实践指导：表驱动测试、辅助函数、竞态检测、覆盖率、基准测试与集成测试。

功能
该技能提供 Go 专属的测试指导，涵盖表驱动测试、测试辅助函数、测试夹具与清理、竞态检测、覆盖率分析、基准测试、模拟以及集成测试。它给出代码示例和命令，例如 go test -race、覆盖率分析文件和构建标签。它只是纯说明性参考，本身不生成文件或脚本。
适用场景
适用于编写或改进 Go 测试、提升测试覆盖率、搭建测试基础设施、排查不稳定测试或添加集成测试的场景。也适合优化测试性能和采用地道的 Go 测试惯例。
运行要求
需要 Go 工具链来运行所述命令；部分示例涉及 sqlite3、testcontainers 和 benchstat。该技能不附带脚本。

Go Testing

This skill provides comprehensive Go testing patterns extending common testing principles with Go-specific idioms.

Testing Framework

Use the standard go test with table-driven tests as the primary pattern.

Table-Driven Tests

The idiomatic Go testing pattern:

go
func TestValidateEmail(t *testing.T) {    tests := []struct {        name    string        email   string        wantErr bool    }{        {            name:    "valid email",            email:   "[email protected]",            wantErr: false,        },        {            name:    "missing @",            email:   "userexample.com",            wantErr: true,        },        {            name:    "empty string",            email:   "",            wantErr: true,        },    }
    for _, tt := range tests {        t.Run(tt.name, func(t *testing.T) {            err := ValidateEmail(tt.email)            if (err != nil) != tt.wantErr {                t.Errorf("ValidateEmail(%q) error = %v, wantErr %v",                    tt.email, err, tt.wantErr)            }        })    }}

Benefits:

  • Easy to add new test cases
  • Clear test case documentation
  • Parallel test execution with t.Parallel()
  • Isolated subtests with t.Run()

Test Helpers

Use t.Helper() to mark helper functions:

go
func assertNoError(t *testing.T, err error) {    t.Helper()    if err != nil {        t.Fatalf("unexpected error: %v", err)    }}
func assertEqual(t *testing.T, got, want interface{}) {    t.Helper()    if !reflect.DeepEqual(got, want) {        t.Errorf("got %v, want %v", got, want)    }}

Benefits:

  • Correct line numbers in test failures
  • Reusable test utilities
  • Cleaner test code

Test Fixtures

Use t.Cleanup() for resource cleanup:

go
func testDB(t *testing.T) *sql.DB {    t.Helper()
    db, err := sql.Open("sqlite3", ":memory:")    if err != nil {        t.Fatalf("failed to open test db: %v", err)    }
    // Cleanup runs after test completes    t.Cleanup(func() {        if err := db.Close(); err != nil {            t.Errorf("failed to close db: %v", err)        }    })
    return db}
func TestUserRepository(t *testing.T) {    db := testDB(t)    repo := NewUserRepository(db)    // ... test logic}

Race Detection

Always run tests with the -race flag to detect data races:

bash
go test -race ./...

In CI/CD:

yaml
- name: Test with race detector  run: go test -race -timeout 5m ./...

Why:

  • Detects concurrent access bugs
  • Prevents production race conditions
  • Minimal performance overhead in tests

Coverage Analysis

Basic Coverage

bash
go test -cover ./...

Detailed Coverage Report

bash
go test -coverprofile=coverage.out ./...go tool cover -html=coverage.out

Coverage Thresholds

bash
# Fail if coverage below 80%go test -cover ./... | grep -E 'coverage: [0-7][0-9]\.[0-9]%' && exit 1

Benchmarking

go
func BenchmarkValidateEmail(b *testing.B) {    email := "[email protected]"
    b.ResetTimer()    for i := 0; i < b.N; i++ {        ValidateEmail(email)    }}

Run benchmarks:

bash
go test -bench=. -benchmem

Compare benchmarks:

bash
go test -bench=. -benchmem > old.txt# make changesgo test -bench=. -benchmem > new.txtbenchstat old.txt new.txt

Mocking

Interface-Based Mocking

go
type UserRepository interface {    GetUser(id string) (*User, error)}
type mockUserRepository struct {    users map[string]*User    err   error}
func (m *mockUserRepository) GetUser(id string) (*User, error) {    if m.err != nil {        return nil, m.err    }    return m.users[id], nil}
func TestUserService(t *testing.T) {    mock := &mockUserRepository{        users: map[string]*User{            "1": {ID: "1", Name: "Alice"},        },    }
    service := NewUserService(mock)    // ... test logic}

Integration Tests

Build Tags

go
//go:build integration// +build integration
package user_test
func TestUserRepository_Integration(t *testing.T) {    // ... integration test}

Run integration tests:

bash
go test -tags=integration ./...

Test Containers

go
func TestWithPostgres(t *testing.T) {    if testing.Short() {        t.Skip("skipping integration test")    }
    // Setup test container    ctx := context.Background()    container, err := testcontainers.GenericContainer(ctx, ...)    assertNoError(t, err)
    t.Cleanup(func() {        container.Terminate(ctx)    })
    // ... test logic}

Test Organization

File Structure

package/├── user.go├── user_test.go          # Unit tests├── user_integration_test.go  # Integration tests└── testdata/             # Test fixtures    └── users.json

Package Naming

go
// Black-box testing (external perspective)package user_test
// White-box testing (internal access)package user

Common Patterns

Testing HTTP Handlers

go
func TestUserHandler(t *testing.T) {    req := httptest.NewRequest("GET", "/users/1", nil)    rec := httptest.NewRecorder()
    handler := NewUserHandler(mockRepo)    handler.ServeHTTP(rec, req)
    assertEqual(t, rec.Code, http.StatusOK)}

Testing with Context

go
func TestWithTimeout(t *testing.T) {    ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond)    defer cancel()
    err := SlowOperation(ctx)    if !errors.Is(err, context.DeadlineExceeded) {        t.Errorf("expected timeout error, got %v", err)    }}

Best Practices

  1. Use t.Parallel() for independent tests
  2. Use testing.Short() to skip slow tests
  3. Use t.TempDir() for temporary directories
  4. Use t.Setenv() for environment variables
  5. Avoid init() in test files
  6. Keep tests focused - one behavior per test
  7. Use meaningful test names - describe what's being tested

When to Use This Skill

  • Writing new Go tests
  • Improving test coverage
  • Setting up test infrastructure
  • Debugging flaky tests
  • Optimizing test performance
  • Implementing integration tests

来源与署名

来源：affaan-m/ECC位于.kiro/skills/golang-testing提交ef648e0

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 affaan-m/ECC 的技能

Unified Notifications Ops

affaan-m

设计统一的通知策略，对来自 GitHub、Linear、钩子和聊天工具的通知进行分类、路由、去重和升级。

Productivity & Workflow275K4天前更新

Verification Loop

affaan-m

执行六阶段代码验证流程，并生成 PASS/FAIL 就绪报告。

Software Development275K4天前更新

Ui To Vue

affaan-m

将批量 UI 设计截图转换为使用 Vant、Element Plus 或 Ant Design Vue 的 Vue 3 组件。

Software Development275K4天前更新

Unified Memory

affaan-m

指导智能体通过本地 ECC Memory Vault 在不同执行框架之间共享持久上下文与交接信息。

AI & Agents275K4天前更新

Visa Doc Translate

affaan-m

通过 OCR 将签证文件图片翻译成英文，并生成原图与译文对照的双语 PDF。

Documents & Office275K4天前更新

Team Builder

affaan-m

交互式选择器：发现可用的智能体角色，让用户最多选择五个，并行执行同一任务并汇总结果。

AI & Agents275K4天前更新

更多Software Development技能

Playground

anthropics

精选

构建自包含的交互式 HTML 演练场，包含控件、实时预览和可复制的提示词输出。

Software Development37K今天更新

M5 Onboard

anthropics

精选

通过 USB 检测 M5Stack ESP32 开发板，刷写 UIFlow 2.0 固件并安装 MicroPython 应用包。

Software Development37K今天更新

Cardputer Buddy

anthropics

精选

指导迭代 Cardputer-Adv 的 MicroPython 应用包：添加应用、通过 USB 串口推送文件、查看日志并运行 REPL 命令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精选

依据从远程来源获取的 Web Interface Guidelines 审查 UI 代码，并以 file:line 形式报告问题。

Software Development32K5周前更新

Vercel React Native Skills

vercel-labs

精选

React Native 与 Expo 最佳实践规则，涵盖列表性能、动画、导航、UI 模式、状态与 monorepo 配置。

Software Development32K5周前更新

Vercel React Best Practices

vercel-labs

精选

Vercel 的 React 与 Next.js 性能指南，以 70 条规则的形式用于编写、审查和重构代码。

Software Development32K5周前更新