#if DEBUGとは何か？C#におけるDebugとReleaseモードの使い方を解説

Visual Studioには、.NETプロジェクトをビルドするための「Debug（デバッグ）」と「Release（リリース）」という2つの異なるビルド構成が用意されています。それぞれの違いと、#if DEBUGディレクティブの使い方について詳しく解説します。

DebugモードとReleaseモードの違い

プロジェクトの開発中にコードを1行ずつステップ実行しながらデバッグを行いたい場合は「Debug」モードを選択します。一方、最終的なアセンブリファイル（.dllや.exe）を作成して配布・公開する際には「Release」モードを選択します。

Debugモードでは、生成されるバイナリは最適化されません。これは、ソースコードと生成された命令との対応関係を単純に保つためです。その結果、ブレークポイントを正確に設定でき、プログラマーはコードを1行ずつステップ実行しながら動作を確認できます。

また、Debug構成でコンパイルされたプログラムには完全なシンボリックデバッグ情報が含まれており、デバッガーが現在ソースコード上のどの位置を実行しているのかを特定できるようになっています。

対照的に、Release構成ではシンボリックデバッグ情報は含まれず、パフォーマンスを最大化するために完全に最適化されたバイナリが生成されます。

ビルド構成を変更する方法

ビルド構成を切り替えるには、以下のいずれかの方法を使用します。

• [ビルド]メニューから： [ビルド]メニュー → [構成マネージャー]を選択し、「Debug」または「Release」を選びます。
• ツールバーから： ツールバーにある「ソリューション構成」ドロップダウンリストから「Debug」または「Release」を選択します。

#if DEBUGディレクティブの動作

#if DEBUGブロック内に記述されたコードは、プログラムがDebugモードで実行されている場合にのみ実行されます。

逆に、プログラムがReleaseモードで実行されている場合、#if DEBUGはfalseと評価され、このブロック内のコードはコンパイル時に除外されるため実行されません。

コード例

class Program {
    static void Main() {
        #if DEBUG
        Console.WriteLine("You are in debug");
        #endif
        Console.ReadKey();
    }
}

このプログラムをDebugモードで実行した場合、#if DEBUGブロックはtrueと評価され、コンソールに「You are in debug」というメッセージが出力されます。

一方、Debugモード以外（Releaseモード）で実行した場合は、#if DEBUGはfalseと評価されるため、メッセージは表示されません。

このように#if DEBUGを使うことで、開発時のみ必要なログ出力やテストコードを、リリース版には含めずに管理することができます。