Go 코드를 어떻게 테스트하나요?

Question

Go 코드를 어떻게 테스트하나요?

Accepted Answer

Go는 `testing` 패키지와 `go test` 명령을 통해 **내장 테스트**를 제공합니다 — 외부 프레임워크가 필요 없습니다. 테스트는 `_test.go` 파일에 있으며, Go는 **테이블 기반 테스트**, 벤치마크, 좋은 도구를 일급 기능으로 강하게 강조합니다.

## 기본 테스트

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

// math_test.go — 같은 패키지, _test.go 접미사
import "testing"

func TestAdd(t *testing.T) {     // Test 접두사 + *testing.T 매개변수
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("Add(2,3) = %d; want 5", result)   // 실패 보고(계속)
        // t.Fatalf는 테스트를 즉시 중단
    }
}
// 실행: go test  (verbose는 `go test -v`, 모든 패키지는 `go test ./...`)
```

테스트 함수는 `Test`로 시작하고, `*testing.T`를 받으며, `t.Errorf`/`t.Fatalf`로 실패를 보고합니다. 단언 키워드가 없습니다 — 평범한 `if`로 조건을 확인하고 실패를 보고합니다(Go는 이 명시적 스타일을 선호).

## 테이블 기반 테스트 — 관용적 Go 패턴

```go
func TestAdd(t *testing.T) {
    tests := []struct {           // 테스트 케이스의 테이블
        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) {     // 케이스당 서브테스트(명명, 격리)
            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 관용구입니다 — 케이스의 slice를 정의하고 `t.Run` 서브테스트로 반복합니다. 케이스 추가가 간단하고 케이스별로 명확한 개별 통과/실패 보고를 제공합니다.

## 벤치마크 — 내장 성능 테스트

```go
func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {     // 프레임워크가 통계적 정확성을 위해 b.N을 선택
        Add(2, 3)
    }
}
// go test -bench=. → ns/op 보고(-benchmem로 할당까지)
```

## 커버리지와 기타 도구

```bash
go test -cover                    # 커버리지 백분율
go test -coverprofile=c.out       # 그다음: go tool cover -html=c.out (시각 보고)
go test -race                     # 경쟁 탐지기 — 데이터 경쟁을 찾음(동시성에 결정적)
go test -run TestAdd              # 특정 테스트 실행
```

**`-race` 플래그**가 특히 중요합니다 — 동시 코드의 데이터 경쟁을 탐지하는데, Go의 동시성 초점을 고려하면 핵심 도구입니다.

## 테스트 헬퍼와 설정

```go
func TestMain(m *testing.M) {     // 패키지 수준 설정/정리
    setup()
    code := m.Run()
    teardown()
    os.Exit(code)
}
// t.Helper()는 함수를 테스트 헬퍼로 표시(더 나은 실패 줄 보고)
// HTTP 핸들러 테스트용 httptest 패키지; 의존성 모킹을 위한 interface
```

## 왜 중요한가

테스트는 Go의 일급 내장 기능입니다 — `testing` 패키지와 `go test`는 외부 프레임워크가 필요 없어, 테스트를 핵심 관행으로 보는 Go의 강조를 반영합니다.

관례를 이해하는 것은 필수적인 일상 지식입니다: `_test.go` 파일과 `TestXxx(t *testing.T)` 구조, 명시적(단언 없는) 실패 보고 스타일, 그리고 특히 관용적 Go를 지배하는 **테이블 기반 테스트** 패턴(서브테스트로 케이스별 명확한 보고와 함께 많은 케이스를 간결하게 커버).

똑같이 중요한 것은 Go의 내장 **벤치마크**(테스트 가능한 관심사로서의 성능)와 강력한 **도구** — 커버리지 분석과 특히 동시 코드의 데이터 경쟁을 찾는 **`-race` 탐지기**(Go의 동시성 중심 사용을 고려하면 필수)입니다.

효과적이고 관용적인 Go 테스트를 작성하고, 경쟁 탐지기를 사용하고, 실제 컴포넌트 테스트에 `httptest`/interface를 활용하는 방법을 아는 것은 전문적인 Go 개발의 특징이자 코드 품질 능숙함을 반영하는 흔한 주제입니다.