檢視、儲存及設定組建記錄檔

  • 發行項

在 Visual Studio IDE 中建置專案之後，您可以在 [輸出] 視窗中檢視該組建的資訊。 您可以藉由使用這項資訊，針對建置失敗進行疑難排解、檢視用於所有建置工具的確切命令列，或取得整個建置流程的完整診斷資訊。

  • 針對 C++ 專案，您也可以檢視在建置專案時建立和儲存之記錄檔中的相同資訊。

  • 對於 .NET 專案，您可以在建置輸出視窗中按一下，然後按 Ctrl+S。 Visual Studio 會提示您輸入位置，以將 [輸出] 視窗中的資訊儲存至記錄檔。

您也可以使用 IDE 來指定您想要檢視每個組建的資訊種類。

如果您使用 MSBuild 建置任何種類的專案，則可以建立記錄檔以儲存組建資訊。 如需詳細資訊，請參閱取得組建記錄檔。

檢視 C++ 專案的組建記錄檔

  1. 在 [Windows 檔案總管] 或 [檔案總管] 中，開啟下列檔案 (相對於專案根資料夾)：Release\{ProjectName}.Log 或 Debug\{ProjectName}.log

建立受控碼專案的組建記錄檔

  1. 在功能表列上選擇 [建置]>[建置解決方案]。

  2. 在 [輸出] 視窗中，按一下文字中的某處。

  3. 按 Ctrl+S。

    Visual Studio 會提示您輸入要儲存建置輸出的位置。

您也可以透過直接從命令列執行 MSBuild (使用 -fileLogger (-fl) 命令列選項) 來產生記錄。 請參閱使用 MSBuild 取得組建記錄檔。

變更組建記錄檔中包含的資訊量

  1. 在功能表列上選擇 [工具]>[選項]。

  2. 在 [專案和解決方案] 頁面上，選擇 [建置並執行] 頁面。

  3. 在 [MSBuild 專案建置輸出詳細程度] 清單中，選擇其中一個值，然後選擇 [確定] 按鈕。

下表顯示記錄檔的詳細資訊 (資料行值) 對記錄哪些類型的訊息 (資料列的值) 有什麼影響。

訊息類型/ 詳細資訊 Quiet 最小 正常 詳細 Diagnostic
錯誤 ✅ ✅ ✅ ✅ ✅
警告 ✅ ✅ ✅ ✅ ✅
高重要性的訊息 ✅ ✅ ✅ ✅
一般重要性的訊息 ✅ ✅ ✅
低重要性的訊息 ✅ ✅
MSBuild 引擎的其他資訊 ✅

如果您想要查看編譯器和其他工具所使用的命令列，請選擇至少詳細詳細程度。

如需詳細資訊，請參閱選項對話方塊、專案和解決方案、建置並執行及 LoggerVerbosity。

重要

您必須重建專案，變更才會在 [輸出] 視窗 (所有專案) 和 <ProjectName>.txt 檔案 (僅限 C++ 專案) 中生效。

使用二進位記錄檔來輕鬆瀏覽大型記錄檔

二進位記錄檔是適用於 .NET 專案的選擇性功能，它可讓您擁有更豐富的記錄檔瀏覽體驗，以便您可以輕鬆地在大型記錄中尋找資訊。 若要使用二進位記錄檔，請安裝 Project System Tools。 如需詳細資訊，請參閱 https://msbuildlog.com 與二進位記錄檔。

二進位記錄檔是適用於 .NET 專案的選擇性功能，它可讓您擁有更豐富的記錄檔瀏覽體驗，以便您可以輕鬆地在大型記錄中尋找資訊。 若要使用二進位記錄檔，請安裝 Project System Tools 2022。 如需詳細資訊，請參閱 https://msbuildlog.com 與二進位記錄檔。

相關內容