Vorgehensweise: Anzeigen, Speichern und Konfigurieren von BuildprotokolldateienHow to: View, save, and configure build log files

Nachdem Sie ein Projekt in der Visual Studio-IDE erstellt haben, werden Informationen zu diesem Build im Fenster Ausgabe angezeigt.After you build a project in the Visual Studio IDE, you can view information about that build in the Output window. Anhand dieser Informationen können Sie beispielsweise einen Buildfehler beheben.By using this information, you can, for example, troubleshoot a build failure.

  • Bei C++-Projekten werden die gleichen Informationen auch in einer TXT-Datei angezeigt, die automatisch erstellt und gespeichert wird.For C++ projects, you can also view the same information in a .txt file that's created and saved automatically.

  • Bei Projekten mit verwaltetem Code können Sie in das Buildausgabefenster klicken und STRG+S drücken.For managed code projects, you can click in the build output window and press Ctrl+S. Visual Studio fordert Sie auf, einen Speicherort auszuwählen, an dem die Informationen aus dem Ausgabefenster in einer .txt-Datei gespeichert werden sollen.Visual Studio prompts you for a location to save the information from the Output window into a .txt file.

Sie können die IDE ebenfalls verwenden, um anzugeben, welche Informationen zu jedem Build angezeigt werden sollen.You can also use the IDE to specify what kinds of information you want to view about each build.

Wenn Sie ein Projekt mithilfe von MSBuild erstellen, können Sie eine TXT-Datei erstellen, um Informationen zum Build zu speichern.If you build any kind of project by using MSBuild, you can create a .txt file to save information about the build. Weitere Informationen finden Sie unter Erhalten von Buildprotokollen.For more information, see Obtain build logs.

Anzeigen der Buildprotokolldatei für ein C++-ProjektTo view the build log file for a C++ project

  1. Öffnen Sie im Windows-Explorer oder im Datei-Explorer folgende Datei: \...\Visual Studio <Version>\Projects\<ProjectName>\<ProjectName>\Debug\<ProjectName>.txtIn Windows Explorer or File Explorer, open the following file: \...\Visual Studio <Version>\Projects\<ProjectName>\<ProjectName>\Debug\<ProjectName>.txt

Erstellen einer Buildprotokolldatei für ein Projekt mit verwaltetem CodeTo create a build log file for a managed-code project

  1. Wählen Sie auf der Menüleiste Erstellen > Projektmappe erstellen aus.On the menu bar, choose Build > Build Solution.

  2. Klicken Sie im Ausgabefenster auf eine beliebige Stelle im Text.In the Output window, click somewhere in the text.

  3. Drücken Sie STRG+S.Press Ctrl+S.

    Visual Studio fordert Sie auf, einen Speicherort auszuwählen, an dem die Buildausgabe gespeichert werden soll.Visual Studio prompts you for a location to save the build output.

Sie können auch Protokolle generieren, indem Sie MSBuild direkt von der Befehlszeile ausführen. Verwenden Sie dabei die Befehlszeilenoption -fileLogger (-fl).You can also generate logs by running MSBuild directly from the command line, using the -fileLogger (-fl) command-line option. Informationen dazu finden Sie unter Erhalten von Buildprotokollen mit MSBuild.See Obtain build logs with MSBuild.

Ändern der Informationsmenge im BuildprotokollTo change the amount of information included in the build log

  1. Wählen Sie in der Menüleiste Extras > Optionen aus.On the menu bar, choose Tools > Options.

  2. Klicken Sie auf der Seite Projekte und Projektmappen auf Erstellen und Ausführen.On the Projects and Solutions page, choose the Build and Run page.

  3. Wählen Sie einen der folgenden Werte aus der Liste Ausführlichkeit der MSBuild-Projektbuildausgabe aus, und klicken Sie dann auf die Schaltfläche OK.In the MSBuild project build output verbosity list, choose one of the following values, and then choose the OK button.

    AusführlichkeitsgradVerbosity level BESCHREIBUNGDescription
    StillQuiet Zeigt ausschließlich eine Zusammenfassung des Builds an.Displays a summary of the build only.
    MinimalMinimal Zeigt eine Zusammenfassung des Builds sowie Fehler, Warnungen und Meldungen an, die als äußerst wichtig eingestuft werden.Displays a summary of the build and errors, warnings, and messages that are categorized as highly important.
    NormalNormal Zeigt eine Zusammenfassung des Builds, die wichtigsten Schritte des Builds sowie Fehler, Warnungen und Meldungen an, die als äußerst wichtig eingestuft werden.Displays a summary of the build; errors, warnings, and messages that are categorized as highly important; and the main steps of the build. Diese Detailebene verwenden Sie am häufigsten.You'll use this level of detail most frequently.
    DetailliertDetailed Zeigt eine Zusammenfassung des Builds, alle Schritte des Builds sowie Fehler, Warnungen und Meldungen an, die als äußerst wichtig eingestuft werden. Außerdem werden Meldungen von normaler Wichtigkeit angezeigt.Displays a summary of the build; errors, warnings, and messages that are categorized as highly important; all of the steps of the build; and messages that are categorized as of normal importance.
    DiagnoseDiagnostic Zeigt alle Daten an, die für den Build verfügbar sind.Displays all data that's available for the build. Sie können diese Detailebene für das Debuggen von Fehlern bei benutzerdefinierten Buildskripts und anderen Buildfehlern verwenden.You can use this level of detail to help debug issues with custom build scripts and other build issues.

    Weitere Informationen finden Sie unter Optionen (Dialogfeld), Projekte und Projektmappen, Erstellen und Ausführen und LoggerVerbosity.For more information, see Options dialog box, Projects and Solutions, Build and Run and LoggerVerbosity.

    Important

    Sie müssen das Projekt neu erstellen, damit Ihre Änderungen im Fenster Ausgabe (alle Projekte) und in der Datei <Projektname>.txt (nur C++-Projekte) wirksam werden.You must rebuild the project for your changes to take effect in the Output window (all projects) and the <ProjectName>.txt file (C++ projects only).

Verwenden von Binärprotokollen, um das Durchsuchen großer Protokolldateien zu vereinfachenUse binary logs to make it easier to browse large log files

Binärprotokolle sind ein optionales Feature für .NET-Projekte, mit dem das Suchen von Informationen in umfangreichen Protokollen benutzerfreundlicher und einfacher wird.Binary logs are an optional feature for .NET projects that lets you have a richer log browsing experience that might make it easier to find information in large logs. Um Binärprotokolle zu verwenden, installieren Sie die Projektsystemtools.To use binary logs, install the Project System Tools. Weitere Informationen finden Sie unter https://msbuildlog.com und Binary Log (Binärprotokoll).For more information, see https://msbuildlog.com and Binary Log

Siehe auchSee also