ビルド ログ ファイルを表示、保存、および構成する
Visual Studio 対話型開発環境 (IDE) でプロジェクトをビルドした後、Visual Studio の 出力 ウィンドウでビルドに関するログ情報を表示できます。 出力データはログ ファイルに保存でき、Visual Studio やその他のエディターで表示できます。
ログはビルドの問題のトラブルシューティングに役立ちます。 すべてのビルド ツールで使用される正確なコマンド ラインを見つけ、ビルド プロセス全体に関する完全な診断データを取得できます。 Visual Studio には、ビルド出力とビルド ログ ファイルに表示する情報の種類を指定するためのオプションが用意されています。
この記事では、Visual Studio でビルド ログ ファイルを生成、構成、表示する方法について説明します。
ビルドログファイルを生成して表示する
シナリオのビルド ログ ファイルを生成および表示するには、次の手順に従います。
C++ プロジェクト:
Visual Studio は、プロジェクトをビルドするときにログ ファイルを保存します。 ログ ファイルの一般的な場所には、 Release\<ProjectName>.log、 Debug\<ProjectName>.log、 <ProjectName>.txt などがあります。 すべてのファイルの場所はプロジェクトのルート フォルダーを基準とし、特定の構成に基づきます。
ログ ファイルを参照するには、 Windows Explorer または File Explorer を使用します。
好みのエディターでログ ファイルを開きます。
.NET プロジェクト:
.NET プロジェクトの場合、Visual Studio にログ ファイルを保存するように指示します。
Visual Studio で、 [構築]>[ソリューションのビルド]を選択します。
出力 ウィンドウでテキストを選択し、 Ctrl+S キーボードショートカットを使用します。
Visual Studio から、ビルド出力を保存する場所を指定することを求められます。 その後、その場所から Visual Studio または別のエディターでログ ファイルを開くことができます。
MSBuild:
-fileLogger
(-fl
) コマンドライン オプションを使用して、コマンドラインから直接 MSBuild を実行することで、ビルド ログを生成できます。 詳細については、「MSBuild を使用してビルド ログを取得する」を参照してください。
ビルドログのデータの詳細度を指定する
ビルド ログ ファイルに含める情報の量を指定できます。 ログ ファイル列のデータ量は、 ロガーの詳細度として測定されます。 ログ ファイルの行数は、 収集されたメッセージを表します。 ログの詳細度 (列の値) は、ログに記録されるメッセージの種類 (行の値) に影響します。 Quiet 冗長性により、ビルド出力に最小限のログが生成されます。 診断 は最も詳細な設定であり、すべての可能なデータを含むログ ファイルを生成します。
次の表は、ロガーの詳細度に基づいて収集されるメッセージの種類を示しています。
メッセージの種類と詳細 | Quiet | 最小 | 標準 | 詳細 | 診断 |
---|---|---|---|---|---|
エラー | ✅ | ✅ | ✅ | ✅ | ✅ |
警告 | ✅ | ✅ | ✅ | ✅ | ✅ |
重要度の高いメッセージ | ✅ | ✅ | ✅ | ✅ | |
重要度が通常のメッセージ | ✅ | ✅ | ✅ | ||
重要度の低いメッセージ | ✅ | ✅ | |||
その他の MSBuild エンジン情報 | ✅ |
ロガーの詳細度は次の手順で設定できます。
Visual Studio で、 ツール>オプション を選択して、 オプション ダイアログを開きます。
ダイアログで、 プロジェクトとソリューション セクションを展開し、 ビルドと実行 タブを選択します。
MSBuild プロジェクト ビルド出力の詳細度 ドロップダウン リストを使用して、ビルド出力の設定を選択します。
MSBuild プロジェクト ビルド ログ ファイルの詳細度 ドロップダウン リストを使用して、ロガーの詳細度設定を選択します。
ヒント
コンパイラやその他のツールに使用されたコマンド ラインを表示する場合は、少なくとも [詳細] の詳細レベルを選択してください。
変更を適用するには、 [OK]を選択します。
重要
変更内容を 出力 ウィンドウで有効にするには、プロジェクトを再構築する必要があります。 C++ プロジェクトの場合、プロジェクトの再構築により、変更が <ProjectName>.txt ファイルにも反映されます。
詳細については、「[オプション] ダイアログ ボックス、[プロジェクトおよびソリューション]、[ビルド/実行]」および「LoggerVerbosity」を参照してください。
大きなログファイルにはバイナリログを使用する
バイナリ ログは .NET プロジェクトのオプション機能です。これにより、ログ参照のエクスペリエンスが向上し、大きなログで情報を見つけやすくなります。 バイナリ ログを使用するには、 Project System Toolsをインストールします。 詳細については、 https://msbuildlog.com
および バイナリ ログに関する記事を参照してください。
バイナリ ログは .NET プロジェクトのオプション機能です。これにより、ログ参照のエクスペリエンスが向上し、大きなログで情報を見つけやすくなります。 バイナリ ログを使用するには、 Project System Tools 2022をインストールします。 詳細については、 https://msbuildlog.com
および バイナリ ログに関する記事を参照してください。