【C#入門】コメントの書き方を解説！複数行コメントと1行コメントの使い分け

コメントとは、コードの意図や処理内容を説明するために記述する注釈のことです。コンパイラはコメント部分を完全に無視するため、プログラムの動作には一切影響しません。C#では、複数行にわたるコメントは「/*」で始まり「*/」で終わります。

複数行コメント（マルチラインコメント）

/* ここから複数行の
コメントが始まります */

「/* ... */」で囲まれた範囲はすべてコメントとして扱われ、コンパイラによって無視されます。長い説明や処理の概要などを記述するのに便利です。

1行コメント（シングルラインコメント）

// variable
int a = 10;

1行だけの簡単なコメントを記述したい場合は「//」を使用します。「//」以降からその行の末尾までがコメントとして扱われます。変数の意味や処理の補足説明などによく使われます。

それでは、1行コメントと複数行コメントの両方を使ったC#プログラムのサンプルを見てみましょう。

サンプルプログラム

using System;

namespace HelloWorldApplication {
    class HelloWorld {
        static void Main(string[] args) {
            /* C#の学習を始めました。
            これは私の最初のプログラムです */

            // テキストを表示する
            Console.WriteLine("Learn C# now!");
            Console.ReadKey();
        }
    }
}

実行結果

Learn C# now!

このように、コメント内の記述は出力に反映されず、プログラムの実行結果には影響しないことが確認できます。

補足：XMLドキュメントコメントについて

C#にはもうひとつ、「///」（スラッシュ3つ）で始まるXMLドキュメントコメントという特殊なコメント形式があります。これはメソッドやクラスの仕様を記述するためのもので、Visual StudioのIntelliSense（入力候補表示）に自動的に反映されるため、チーム開発やライブラリ開発で非常に役立ちます。

/// <summary>
/// 数値を2倍にして返します。
/// </summary>
int Double(int value) {
    return value * 2;
}

適切なコメントを付けることで、コードの可読性が大きく向上し、後から見返したときや他の人が読むときにも理解しやすくなります。ぜひ日頃のコーディングから活用してみてください。