Test

Go プロジェクトのユニットテストを実行します。カバレッジ計測、特定パッケージ/ファイルのテスト、レースコンディション検出に対応。

引数

• •[パッケージパス]: テスト対象のパッケージ（例: ./internal/handler）
• •--cover: カバレッジ計測を有効化
• •--race: データレース検出を有効化
• •--help: ヘルプを表示

実行手順

1. タスクランナー検出

ls -la Taskfile.yml Makefile 2>/dev/null

検出されるタスク名の例:

• •test, test-unit, go-test
• •test:unit, unit-test

2. テスト実行

# タスクランナーがある場合
task test
make test

# タスクランナーがない場合
go test ./...

# カバレッジ付き
go test -cover ./...

# カバレッジレポート生成
go test -coverprofile=coverage.out ./...
go tool cover -func=coverage.out

# レースコンディション検出
go test -race ./...

# 特定パッケージのテスト
go test -v ./internal/handler

# 特定テストケースのみ
go test -v -run TestCreateUser ./internal/handler

3. 結果レポート

✅ テスト完了

実行パッケージ数: {N}
実行テスト数: {M}
成功: {S}
失敗: {F}
スキップ: {K}
実行時間: {T}s

カバレッジ: {C}%

失敗したテスト:
- {パッケージ/テスト名}
  エラー: {エラーメッセージ}

段階的テスト実行戦略

効率的なデバッグのため、以下の順序でテストを実行:

1. •特定テストケース - go test -v -run TestXxx ./path
2. •特定テストファイル - 対象ファイルのみ
3. •特定パッケージ - go test -v ./internal/handler
4. •プロジェクト全体 - go test ./...

重要な注意事項

• •✅ タスクランナーがあれば使用
• •✅ -race フラグで並行処理の問題を検出
• •✅ キャッシュを無効化するには -count=1 を使用
• •❌ -race フラグは実行速度が遅くなるため、開発時のみ使用推奨