先生と生徒の会話形式で理解しよう

生徒

「プログラムを書いた後、本当に全部の行が正しく動くか不安なんです。何か確認する方法はありますか？」

先生

「それは大切な視点ですね。C#には、作成したテストがプログラムのどこをどれだけ通ったかを数値で教えてくれる、テストカバレッジという仕組みがありますよ。」

生徒

「テストカバレッジ？なんだか難しそうですが、初心者でもCoverletなどのツールを使えば計測できるのでしょうか？」

先生

「はい、大丈夫です。Coverletというツールを使えば、視覚的にどこをチェックできていないかが分かります。まずは基本から一緒に見ていきましょう！」

1. テストカバレッジとは？

プログラミングの世界には、作ったプログラムが期待通りに動くかを確かめるためのユニットテスト（単体テスト）という作業があります。しかし、テストを書いただけでは、プログラムの全ての命令を網羅できているかは分かりません。そこで登場するのがテストカバレッジです。

テストカバレッジとは、一言で言うと「プログラム全体の何パーセントをテストで実行できたか」を示す指標のことです。例えば、100行あるプログラムのうち、テストによって80行が実行されたなら、カバレッジは80パーセントとなります。この数値が高いほど、多くの部分がテストによってチェックされているということになり、バグ（プログラムのミス）が隠れている可能性を減らすことができます。

ただし、100パーセントを目指せば絶対に安心というわけではありませんが、全くテストされていない場所を見つけるための非常に便利な「健康診断」のようなものだと考えてください。パソコンに詳しくない方でも、料理のレシピを上から下まで全部試し読みしたかどうかを確認するチェックリストのようなものだと想像すると分かりやすいでしょう。

2. カバレッジ計測ツールCoverletとは？

C#で開発を行う際、標準的に使われるカバレッジ計測ツールがCoverlet（カバレッジレット）です。これは、オープンソースで開発されている非常に軽量で強力なツールです。

通常、テストを実行しても「成功したか失敗したか」しか分かりません。しかし、Coverletを導入すると、テスト実行の裏側で「どのコードが動いたか」をこっそり記録してくれます。そして、最終的に「ここがテストされていませんよ」というレポートを作成してくれます。C#の開発環境である.NET（ドットネット）との相性が抜群で、現在の開発現場では欠かせないツールの一つとなっています。

ツールという言葉を聞くと、何か難しいソフトウェアをインストールしなければならないと感じるかもしれませんが、Coverletはプロジェクトの設定に少し加えるだけで使えるようになるため、初心者の方でも比較的簡単に使い始めることができます。この「自動で調べてくれる便利さ」をぜひ体験してみましょう。

3. テスト対象となるシンプルなプログラムの準備

まずは、カバレッジを測るための簡単なプログラムを準備しましょう。今回は、入力された数字が偶数か奇数かを判定する簡単な計算機を作成します。プログラムが条件によって分かれているところがポイントです。このように条件によって道が分かれるところを分岐（ぶんき）と呼びます。カバレッジは、この全ての道を通ったかを確認するために役立ちます。


public class NumberChecker
{
    public string CheckEvenOrOdd(int number)
    {
        if (number % 2 == 0)
        {
            return "偶数です";
        }
        else
        {
            return "奇数です";
        }
    }
}

このプログラムには「偶数の場合の道」と「奇数の場合の道」の2種類があります。もし、テストで偶数の数字しか入力しなかった場合、奇数の処理を通っていないことになり、カバレッジは低くなってしまいます。

4. ユニットテストを書いてみよう

次に、先ほどのプログラムが正しく動くかを確認するためのテストプログラムを書きます。C#ではxUnit（エックスユニット）というライブラリがよく使われます。ここでは、まず「偶数」の場合だけを確認するテストを1つだけ作成してみます。あえて片方だけのテストにすることで、後でカバレッジの結果がどうなるかを見てみましょう。


using Xunit;

public class NumberCheckerTests
{
    [Fact]
    public void EvenNumberTest()
    {
        // 準備
        var checker = new NumberChecker();
        
        // 実行（10は偶数なので、偶数ですと返ってくるはず）
        var result = checker.CheckEvenOrOdd(10);
        
        // 確認
        Assert.Equal("偶数です", result);
    }
}

このテストコードでは、10という数字を渡して結果が「偶数です」になるかをチェックしています。この段階では、まだカバレッジは計測されていません。次に、Coverletを使ってこのテストを実行し、どのくらい網羅できているかを調べてみましょう。

5. Coverletを使ってカバレッジを計測するコマンド

プログラムの準備ができたら、実際に計測を行います。通常、Windowsの「コマンドプロンプト」や「ターミナル」という黒い画面で命令を入力します。プログラミング未経験の方には少し難しく見えるかもしれませんが、決まった文字を打ち込むだけなので安心してください。

.NETのプロジェクトであれば、以下のコマンドを入力するだけでカバレッジ付きのテストが実行されます。


dotnet test /p:CollectCoverage=true

このコマンドの意味を解説します。dotnet testは「テストを実行してね」という命令です。その後の/p:CollectCoverage=trueが重要で、「ついでにカバレッジも集めて（Collect）おいてね」というオプション（追加の指示）になります。これを実行すると、テストが走り、最後に表形式で結果が表示されます。画面には「Line coverage」などの項目が出てきて、何パーセント達成できたかが一目で分かります。

6. 計測結果のレポートを詳しく見てみよう

コマンドを実行すると、以下のような結果が表示されます。これは、どのくらいテストが網羅されているかを示す成績表のようなものです。専門用語が出てきますが、一つずつ解説します。まずは出力される結果のイメージを確認してください。


+----------------+--------+--------+--------+
| Module         | Line   | Branch | Method |
+----------------+--------+--------+--------+
| SampleProject  | 75%    | 50%    | 100%   |
+----------------+--------+--------+--------+

Line（ラインカバレッジ）：これは行数の網羅率です。全行のうち、何行がテスト中に実行されたかを示します。Branch（ブランチカバレッジ）：これは枝分かれの網羅率です。if文などで分かれた「全ての条件の道」を通ったかを示します。先ほどの例では、偶数しかテストしていないので、奇数の道を通っていないためここが50パーセントになります。Method（メソッドカバレッジ）：これは関数（ひとまとまりの処理）が少なくとも一度は呼ばれたかを示します。

初心者のうちは、まずこの「Line」と「Branch」に注目しましょう。数値が100パーセントになっていなければ、どこかにテストし忘れたパターンがあるということになります。これを見つけることで、予期せぬ動作を未然に防ぐことができるのです。

7. 100パーセントにするためのテスト追加

先ほどのレポートで、カバレッジが100パーセントではなかったことが分かりました。原因は「奇数の場合の処理」をテストしていないからです。そこで、新たに奇数のテストケースを追加してみましょう。複数のパターンを試すことで、プログラムの信頼性を高めていきます。


[Fact]
public void OddNumberTest()
{
    var checker = new NumberChecker();
    
    // 7は奇数なので、奇数ですと返ってくるはず
    var result = checker.CheckEvenOrOdd(7);
    
    Assert.Equal("奇数です", result);
}

このテストを追加した状態で、もう一度dotnet test /p:CollectCoverage=trueを実行してみましょう。今度はif文の「else（そうでなければ）」の方の道も通ることになるため、LineカバレッジもBranchカバレッジも100パーセントになるはずです。このように、ツールを使いながら足りないテストを埋めていく作業をカバレッジ主導のテスト作成と呼ぶこともあります。

8. より複雑な条件でのカバレッジ計測

もっと複雑なプログラムでも試してみましょう。例えば、年齢によって料金が変わる仕組みなど、条件がたくさんある場合です。条件が増えれば増えるほど、人間の頭だけで全てのパターンを確認するのは大変になりますが、Coverletを使えば一発で「ここが漏れている」と指摘してくれます。


public class TicketCalculator
{
    public int GetPrice(int age, bool hasDiscountCoupon)
    {
        if (age < 12)
        {
            return 500; // 子供料金
        }
        
        if (hasDiscountCoupon)
        {
            return 800; // クーポンあり大人
        }
        
        return 1000; // 通常大人料金
    }
}

このプログラムには3つの出口（return）があります。12歳未満の子供、クーポンを持っている人、どちらでもない大人です。カバレッジを計測しながらテストを書くと、「クーポンを持っている大人の場合のテストを忘れていた！」といったミスにすぐに気づけます。初心者のうちは、こうした「条件の抜け漏れ」がバグの原因になりやすいため、ツールに頼ることは非常に賢い選択です。Coverletは、私たちが書いたコードという地図を歩き、まだ誰も足を踏み入れていない未開の地（テストされていないコード）を教えてくれる羅針盤のような存在なのです。

9. レポートをファイルに出力して視覚化する

黒い画面に数字が出るだけでも十分便利ですが、大きなプログラムになると、どの行が赤色（未実行）でどの行が緑色（実行済み）か、もっと分かりやすく見たいですよね。Coverletでは、結果をファイルとして保存することができます。特にopencoverという形式で出力すると、別のツールを使って綺麗なグラフや色付きのコード画面に変換できます。


dotnet test /p:CollectCoverage=true /p:CoverletOutputFormat=opencover

このコマンドを実行すると、coverage.opencover.xmlというファイルが作成されます。このファイル自体はコンピュータ用のデータなので人間が見ても分かりにくいですが、ReportGeneratorという別の有名なツールと組み合わせることで、ブラウザで閲覧できるピカピカのHTMLレポートに変身します。プロの開発現場では、このレポートをチーム全員で共有して、品質を確認し合うのが一般的です。最初は難しく考えず、「結果を保存して後で見返せるようにできるんだな」くらいの理解で十分です。

10. なぜ初心者のうちからカバレッジを意識すべきか

最後に、なぜパソコンに慣れていない段階からこのようなツールを知っておくべきかをお話しします。プログラミングの学習が進んでいくと、自分が書いたコードが本当に正しいのか不安になる時期が必ずやってきます。その時に「カバレッジが100パーセントだから、少なくとも書いたコードは全部一回は動かしてみたぞ」という事実は、大きな自信に繋がります。

また、C#という言語は非常に厳格でしっかりとした作りをしているため、テストやデバッグの環境が非常に整っています。Coverletのような優れたツールを使いこなす第一歩を踏み出すことで、将来的にエンジニアとして仕事をする際にも役立つ「品質に対する感覚」を養うことができます。まずは簡単なif文のテストから始めて、カバレッジの数値が上がる楽しさを感じてみてください。ゲームの達成率を上げるような感覚で、楽しみながらテストを書いていきましょう。C#のテスト環境は、皆さんのプログラミング学習を力強くサポートしてくれるはずです。