1. 導入：なぜテストカバレッジの測定が重要なのか
Goで開発を進める際、ただテストを書くだけで満足していませんか？「どのコードがテストされ、どのコードが未検証なのか」を把握することは、バグを未然に防ぎ、リファクタリングを安全に行うために非常に重要です。今回紹介する「go test -coverprofile」は、テストの網羅率（カバレッジ）を測定し、どの行が実行されたかを可視化するための強力なツールです。
2. 基礎知識：カバレッジとプロファイルデータ
カバレッジ（Coverage）とは、プログラムのソースコードのうち、テストを通じてどれだけの割合が実行されたかを示す指標です。Go言語には標準でテストツールが組み込まれており、その機能の一つとして「プロファイルデータ（統計情報）」の出力があります。このデータは人間が直接読むためのものではなく、解析ツールが読み取ってHTMLなどで視覚化するための「原材料」となります。
3. 実装/解決策：カバレッジを取得する手順
カバレッジを取得する手順は非常にシンプルです。以下の2ステップで行います。
1. テスト実行時に -coverprofile オプションを付けてプロファイルデータを出力する。
2. 出力されたデータを go tool cover コマンドで HTML ファイルに変換する。
これにより、ブラウザ上でソースコードのどの行がテスト済みか（緑色）、未実行か（赤色）を一目で確認できるようになります。
4. サンプルプログラム：実際に試してみよう
まずは、以下のコードを calculator.go として保存し、それに対するテストコードを書いてみましょう。
// calculator.go
package main
// Add は二つの整数を加算します
func Add(a, b int) int {
return a + b
}
// Sub は二つの整数を減算します
func Sub(a, b int) int {
return a – b
}
次に、以下のコマンドをターミナルで実行してください。
1. カバレッジプロファイルを作成する
go test -coverprofile=coverage.out
2. プロファイルをHTML形式に変換する
go tool cover -html=coverage.out -o coverage.html
これで生成された coverage.html をブラウザで開くと、Add関数のみがテストされているため、Sub関数が赤く表示され「テスト不足」であることが一目で分かります。
5. 応用・注意点：現場で役立つテクニック
現場で活用する際には、以下の点に注意してください。
・パッケージごとの集計
大規模なプロジェクトでは、全てのパッケージを対象にカバレッジを取得する必要があります。その場合は go test ./… -coverprofile=coverage.out とすることで、プロジェクト全体を一括で解析できます。
・CI/CDへの組み込み
GitHub ActionsなどのCI環境でカバレッジを自動チェックする仕組みを導入するのが一般的です。一定のカバレッジ率（例：80%以上）を下回った場合にビルドを失敗させる設定を行うと、チーム全体の品質維持に大きく貢献します。
・「100%」を目指しすぎない
カバレッジはあくまで指標です。100%にすること自体が目的化すると、テストのためのテストコードが増え、保守性が下がることがあります。重要なロジックを優先的にテストし、ツールを活用して「テストの漏れ」を効率よく防ぐという意識を持つことが、プロのバックエンドエンジニアへの第一歩です。
コメント