Go のコードをどのようにテストしますか？

Question

Accepted Answer

Go には `testing` パッケージと `go test` コマンドを通じた**組み込みテスト**機能があり、外部フレームワークは不要です。テストは `_test.go` ファイルに記述し、Go は**テーブル駆動テスト**、ベンチマーク、そして優れたツール群をファーストクラス機能として強く推奨しています。

## 基本的なテスト

```go
// math.go
func Add(a, b int) int { return a + b }

// math_test.go — same package, _test.go suffix
import "testing"

func TestAdd(t *testing.T) {     // Test prefix + *testing.T parameter
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("Add(2,3) = %d; want 5", result)   // report failure (continues)
        // t.Fatalf stops the test immediately
    }
}
// run with: go test  (or `go test -v` for verbose, `go test ./...` for all packages)
```

テスト関数は `Test` で始まり、`*testing.T` を引数に取り、`t.Errorf`/`t.Fatalf` で失敗を報告します。アサーションキーワードはなく、条件チェックは通常の `if` で行い、失敗を報告します（Go はこの明示的なスタイルを推奨します）。

## テーブル駆動テスト — Go の慣用パターン

```go
func TestAdd(t *testing.T) {
    tests := []struct {           // a table of test CASES
        name     string
        a, b     int
        expected int
    }{
        {"positives", 2, 3, 5},
        {"with zero", 0, 5, 5},
        {"negatives", -1, -1, -2},
    }
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {     // a SUBTEST per case (named, isolated)
            if got := Add(tt.a, tt.b); got != tt.expected {
                t.Errorf("Add(%d,%d) = %d; want %d", tt.a, tt.b, got, tt.expected)
            }
        })
    }
}
```

**テーブル駆動テスト**は Go の主流な手法です。ケースのスライスを定義し、`t.Run` サブテストでループします。この方法はケースの追加が簡単で、ケースごとに明確で個別のパス/フェイルレポートを提供します。

## ベンチマーク — 組み込みパフォーマンステスト

```go
func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {     // the framework chooses b.N for statistical accuracy
        Add(2, 3)
    }
}
// go test -bench=. → reports ns/op (and -benchmem for allocations)
```

## カバレッジとその他のツール

```bash
go test -cover                    # coverage percentage
go test -coverprofile=c.out       # then: go tool cover -html=c.out (visual report)
go test -race                     # the RACE DETECTOR — finds data races (crucial for concurrency)
go test -run TestAdd              # run specific tests
```

**`-race` フラグ**は特に重要です。並行コードのデータレースを検出し、Go の並行処理重視の考え方を反映した重要なツールです。

## テストヘルパーとセットアップ

```go
func TestMain(m *testing.M) {     // package-level setup/teardown
    setup()
    code := m.Run()
    teardown()
    os.Exit(code)
}
// t.Helper() marks a function as a test helper (better failure line reporting)
// httptest package for testing HTTP handlers; interfaces for mocking dependencies
```

## なぜ重要なのか

テストは Go のファーストクラスで組み込みの機能です。`testing` パッケージと `go test` は外部フレームワークを必要とせず、Go がテストをコア実践として重視していることを反映しています。

慣例を理解することは日常的な必須知識です。`_test.go` ファイルと `TestXxx(t *testing.T)` 構造、明示的な（アサーション非依存の）失敗報告スタイル、そして Go で支配的な**テーブル駆動テスト**パターン（サブテストによる明確なケースごとのレポートで、コンパクトに多くのケースをカバー）。

同様に重要なのは Go の組み込み**ベンチマーク**（パフォーマンスをテスト可能な関心事として扱う）と強力な**ツール群**です。カバレッジ分析、特に並行コードのデータレースを検出する強力な**`-race` デテクタ**（Go の並行処理指向の使用方法を考えると重要）。

効果的で慣用的な Go テストの書き方、レースデテクタの使用、そして `httptest`/インターフェースを活用した実コンポーネントのテストは、プロフェッショナルな Go 開発の特徴であり、コード品質リテラシーを反映した頻出トピックです。