Visual Studio でのデバッグおよびリリース構成の設定

Visual Studio プロジェクトでは、ご使用のプログラムに対応するリリースとデバッグ構成を個別に用意しています。 デバッグ バージョンはデバッグ用に、リリース バージョンは最終リリース配布用にビルドします。

デバッグ構成では、プログラムのコンパイルにシンボリック デバッグ情報が完全に含まれ、最適化は行われません。 ソース コードと生成された命令の関係は非常に複雑であり、最適化を行うとデバッグが困難になるためです。

プログラムのリリース構成は、シンボリック デバッグ情報を含まず、完全に最適化されます。 マネージド コードと C++ コードの場合、使用しているコンパイラ オプションによっては、デバッグ情報が .pdb ファイル内に生成される場合があります。 .pdb ファイルを作成すると、後でリリース バージョンをデバッグする際に役立つことがあります。

ビルド構成の詳細については、「ビルド構成について」を参照してください。

ビルド構成は、[ビルド] メニュー、ツールバー、またはプロジェクトのプロパティ ページを使用して変更できます。 プロジェクト プロパティ ページは、言語固有のページです。 次の手順では、メニューとツールバーからビルド構成を変更する方法を示します。 各種言語のプロジェクトでビルド構成を変更する方法の詳細については、以下の「関連するコンテンツ」のセクションを参照してください。

ビルド構成を変更する

ビルド構成を変更するには、次のどちらかを行います。

  • ツールバーの場合は、[ソリューション構成] リスト ボックスから [デバッグ] または [リリース] をクリックします。

    toolbars build configuration

    or

  • [ビルド] メニューからの場合は、[構成マネージャー] を選択し、[デバッグ] または [リリース] を選択します。

ビルド (C#、C++、Visual Basic、F#) のシンボル (.pdb) ファイルを生成する

シンボル (.pdb) ファイルと、それに含めるデバッグ情報を生成するように選択できます。 ほとんどのプロジェクト タイプでは、コンパイラはデバッグ ビルドとリリース ビルドのシンボル ファイルを既定で生成しますが、その他の既定の設定はプロジェクト タイプと Visual Studio のバージョンによって異なります。

重要

デバッガーは、実行可能ファイルがビルドされたときに作成された .pdb ファイルと正確に一致する実行可能ファイルの .pdb ファイルのみ読み込みます (つまり .pdb ファイルはオリジナルまたはオリジナルのコピーであることが必要)。 詳細については、「Why does Visual Studio require debugger symbol files to exactly match the binary files that they were built with?」 (ビルドに使用したバイナリ ファイルと完全に一致させるために、Visual Studio でデバッガー シンボル ファイルが必要な理由) を参照してください。

プロジェクト タイプごとに、これらのオプションを設定する方法が異なる場合があります。

C# または ASP.NET Core プロジェクトのシンボル ファイルを生成する (.NET Core、.NET 5+ のみ)

C# のデバッグ構成の、プロジェクト設定の詳細については、「C# デバッグ構成のプロジェクト設定」を参照してください。 (Visual Basic の .NET プロジェクトの場合、シンボル ファイルは .NET Framework と同様に構成されます。)

  1. ソリューション エクスプローラーでプロジェクトを右クリックし、[プロパティ] を選択します。

  2. サイド ペインで、[ビルド]>[全般] の順に選択します。

  3. [コードの最適化] セクションの [デバッグ] または [リリース] を選択します。

  4. [デバッグ シンボル] の一覧で、[PDB ファイル、現在のプラットフォーム][PBD file, portable]\(PBD ファイル、ポータブル\)、または[埋め込み] を選択します。

    .NET Core の最新のクロスプラットフォーム形式が移植可能です。 詳細については、「[ビルドの詳細設定] ダイアログ ボックス (C#)」を参照してください。

    Generate PDBs for builds in .NET

  5. プロジェクトをビルドする。

    コンパイラは、実行可能ファイルまたはメイン出力ファイルと同じフォルダーにシンボル ファイルを作成します。

C#、ASP.NET、または Visual Basic プロジェクトのシンボル ファイルを生成する (.NET Framework)

C# または Visual Basic のデバッグ構成の、プロジェクト設定の詳細については、「C++ デバッグ構成のプロジェクト設定」または「Visual Basic デバッグ構成のプロジェクト設定」を参照してください。

  1. ソリューション エクスプローラーでプロジェクトを右クリックし、[プロパティ] を選択します。

  2. サイド ペインで、[ビルド] (または Visual Basic の [コンパイル]) を選択します。

  3. 上部にある [構成] ボックスの一覧の [デバッグ] または [リリース] をクリックします。

  4. [詳細] ボタン (または Visual Basic の [詳細コンパイル オプション]) を選択します。

  5. [デバッグ情報] ボックスの一覧 (または Visual Basic の [デバッグ情報の生成] ボックスの一覧) で、[完全][pdb のみ]、または [移植可能] を選択します。

    .NET Core の最新のクロスプラットフォーム形式が移植可能です。 詳細については、「[ビルドの詳細設定] ダイアログ ボックス (C#)」を参照してください。

    Generate PDBs for builds in C#

  6. プロジェクトをビルドする。

    コンパイラは、実行可能ファイルまたはメイン出力ファイルと同じフォルダーにシンボル ファイルを作成します。

C++ プロジェクトのシンボル ファイルを生成する

  1. ソリューション エクスプローラーでプロジェクトを右クリックし、[プロパティ] を選択します。

  2. [構成] ボックスの一覧の [デバッグ] または [リリース] をクリックします。

  3. サイド ペインで、[リンカー] > [デバッグ] を選択し、[デバッグ情報の生成] のオプションを選択します。

    ほとんどの C++ プロジェクトでは、既定値は [デバッグ情報を生成] (/DEBUG) です。

    C++ のデバッグ構成の、プロジェクト設定の詳細については、「C++ デバッグ構成のプロジェクト設定」を参照してください。

  4. プログラム データベース ファイルを生成するためのオプションを構成します。

    ほとんどの C++ プロジェクトでは、既定値は $(OutDir)$(TargetName).pdb です。これにより、出力フォルダーに .pdb ファイルが生成されます。

    Generate PDBs for builds in C++

  5. プロジェクトをビルドする。

    コンパイラは、実行可能ファイルまたはメイン出力ファイルと同じフォルダーにシンボル ファイルを作成します。