Практическое руководство. Просмотр, сохранение и настройка файлов журнала сборкиHow to: View, save, and configure build log files

После сборки проекта в интегрированной среде разработки Visual Studio вы можете просмотреть сведения об этой сборке в окне Вывод.After you build a project in the Visual Studio IDE, you can view information about that build in the Output window. С помощью этих сведений можно, например, найти и устранить сбой при сборке.By using this information, you can, for example, troubleshoot a build failure.

  • Для проектов C++ те же самые сведения можно просмотреть в файле журнала, который создается и сохраняется при создании проекта.For C++ projects, you can also view the same information in a log file that's created and saved when you build a project.

  • Для проектов с управляемым кодом можно щелкнуть в окне вывода построения и нажать клавиши CTRL+S.For managed code projects, you can click in the build output window and press Ctrl+S. В Visual Studio появится запрос на указание расположения для сохранения информации из окна вывода в файле журнала.Visual Studio prompts you for a location to save the information from the Output window into a log file.

Кроме того, можно прямо в интегрированной среде разработки указать, какие сведения вы хотите просмотреть о каждой сборке.You can also use the IDE to specify what kinds of information you want to view about each build.

Если вы создаете любые типы проектов с помощью MSBuild, вы можете создать файл журнала для хранения сведений о сборке.If you build any kind of project by using MSBuild, you can create a log file to save information about the build. Дополнительные сведения см. в разделе Получение журналов сборки.For more information, see Obtain build logs.

Просмотр файла журнала сборки для проекта C++To view the build log file for a C++ project

  1. В проводнике Windows или проводнике откройте следующий файл (относительно корневой папки проекта): Release\>.Log* или Debug\<имя_проекта>.log.In Windows Explorer or File Explorer, open the following file (relative to the project root folder): Release\>.Log* or Debug\<ProjectName>.log

Создание файла журнала сборки для проекта управляемого кодаTo create a build log file for a managed-code project

  1. В строке меню последовательно выберите Сборка > Собрать решение.On the menu bar, choose Build > Build Solution.

  2. В окне вывода щелкните где-нибудь в тексте.In the Output window, click somewhere in the text.

  3. Нажмите клавиши CTRL+S.Press Ctrl+S.

    В Visual Studio появится запрос на указание расположения для сохранения выходных данных сборки.Visual Studio prompts you for a location to save the build output.

Можно также создавать журналы, запустив MSBuild непосредственно из командной строки с помощью параметра командной строки -fileLogger (-fl).You can also generate logs by running MSBuild directly from the command line, using the -fileLogger (-fl) command-line option. См. статью о получении журналов сборки с помощью MSBuild.See Obtain build logs with MSBuild.

Изменение объема сведений, включенных в журнал сборкиTo change the amount of information included in the build log

  1. В строке меню выберите Сервис > Параметры.On the menu bar, choose Tools > Options.

  2. На странице Проекты и решения выберите страницу Сборка и запуск.On the Projects and Solutions page, choose the Build and Run page.

  3. В списке Степень подробности сообщений при построении проекта MSBuild выберите одно из указанных ниже значений, а затем нажмите кнопку ОК.In the MSBuild project build output verbosity list, choose one of the following values, and then choose the OK button.

    Уровень детализацииVerbosity level ОписаниеDescription
    ТихийQuiet Отображает только сводку по сборке.Displays a summary of the build only.
    МинимальноеMinimal Отображает сводку по сборке, а также ошибки, предупреждения и сообщения с высокой важностью.Displays a summary of the build and errors, warnings, and messages that are categorized as highly important.
    ОбычныйNormal Отображает сводку по сборке, ошибки, предупреждения и сообщения с высокой важностью, а также основные шаги сборки.Displays a summary of the build; errors, warnings, and messages that are categorized as highly important; and the main steps of the build. Этот уровень детализации будет использоваться чаще всего.You'll use this level of detail most frequently.
    ПодробныйDetailed Отображает сводку по сборке, ошибки, предупреждения и сообщения с высокой важностью, все шаги сборки, а также сообщения с обычной важностью.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.
    ДиагностическийDiagnostic Отображает все данные, которые доступны для сборки.Displays all data that's available for the build. Этот уровень детализации можно использовать для исправления проблем с пользовательскими скриптами сборки и других проблем сборки.You can use this level of detail to help debug issues with custom build scripts and other build issues.

    Дополнительные сведения см. в разделах Диалоговое окно "Параметры", "Проекты и решения", "Сборка и запуск" и LoggerVerbosity.For more information, see Options dialog box, Projects and Solutions, Build and Run and LoggerVerbosity.

    Важно!

    Вам нужно перестроить проект, чтобы изменения в окне Вывод (все проекты) и файле <имя_проекта>.txt (только проекты C++) вступили в силу.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).

Использование двоичных журналов для упрощения просмотра больших файлов журналаUse binary logs to make it easier to browse large log files

Двоичные журналы — вспомогательная функция в проектах .NET, упрощающая просмотр журналов и поиск информации в больших журналах.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. Для просмотра двоичных журналов нужно установить Project System Tools.To use binary logs, install the Project System Tools. Дополнительные сведения см. на сайте https://msbuildlog.com и GitHub.For more information, see https://msbuildlog.com and Binary Log

См. такжеSee also