共用方式為

教學課程：vcperf 和 Windows 效能分析器

  • 發行項

C++ Build Insights 工具可在 Visual Studio 2019 和更新版本中取得。 若要查看此版本的檔，請將本文的 Visual Studio 版本 選取器控制項設定為 Visual Studio 2019 或更新版本。 其位於此頁面目錄頂端。

在本教學課程中，您將瞭解如何使用 vcperf.exe 來收集 C++ 組建的追蹤。 您也將瞭解如何在 Windows 效能分析器中檢視此追蹤。

步驟 1：安裝和設定 Windows 效能分析器

WPA 是 Windows 評定與部署套件 （ADK） 中可用的追蹤檢視器。 這是個別的公用程式，不屬於您可以使用 Visual Studio 安裝程式安裝的元件。

支援 C++ Build Insights 的 WPA 版本僅適用于編號為 10.1.19041.0 或更新版本的 Windows ADK 版本。

下載並安裝 WPA

注意：安裝 Windows 效能分析器需要 Windows 8 或更新版本。

  1. 流覽至 Windows ADK 下載頁面 。

  2. 下載並安裝最新版本的 Windows ADK。

  3. 當系統提示您輸入要安裝的功能時，請選取 [Windows Performance Toolkit ]。 如有需要，您可以選取其他功能，但不需要安裝 WPA。

    The Windows Performance Analyzer installer's feature selection screen.

設定 WPA

在 WPA 中檢視 C++ Build Insights 追蹤需要特殊的增益集。 請遵循下列步驟進行安裝：

  1. 下載下列其中一個元件來取得增益集。 您不需要取得這兩者。 選擇您找到最方便的。

  2. 將 perf_msvcbuildinsights.dll 檔案複製到您的 WPA 安裝目錄。

    1. 在 Visual Studio 2019 16.6 版和更新版本中，此檔案位於： C:\Program Files (x86)\Microsoft Visual Studio\{Year}\{Edition}\VC\Tools\MSVC\{Version}\bin\Host{Architecture}\{Architecture} 。
    2. 在 C++ Build Insights NuGet 套件中，此檔案位於： wpa\{Architecture} 。
    3. 在上述路徑中，取代以大括弧括住的變數，如下所示：
      1. {Year} 是 Visual Studio 產品年度，例如 2019 或 2022。
      2. {Edition} 是您的 Visual Studio 版本，例如 Community、Professional 或 Enterprise。
      3. {Version} 是您的 MSVC 版本。 選擇最高的可用專案。
      4. {Architecture}x64：選擇您是否有 64 位版本的 Windows。 否則，請選擇 x86 。
    4. WPA 安裝目錄通常是： C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit 。

  3. 在您的 WPA 安裝目錄中，開啟 perfcore.ini 檔案並新增 的專案 perf_msvcbuildinsights.dll 。

步驟 2：使用 vcperf.exe 追蹤您的組建

若要檢視 C++ Build Insights 資料，請先依照下列步驟將它收集到追蹤檔案：

  1. 在系統管理員模式中開啟 VS 的 x64 或 x86 Native Tools 命令提示字元。 （以滑鼠右鍵按一下[開始] 功能表專案，然後選擇 [以系統管理員身分執行更多 > ]。

    1. 如果您有 64 位版本的 Windows，請選擇 x64 。 否則，請選擇 x86 。

  2. 在命令提示字元視窗中，輸入此命令：

    vcperf.exe /start SessionName

    為 SessionName 選擇您記得的 會話名稱。

  3. 像平常一樣建置您的專案。 您不需要使用相同的命令提示字元視窗來建置。

  4. 在命令提示字元視窗中，輸入此命令：

    vcperf.exe /stop SessionName traceFile.etl

    使用您之前針對 SessionName 所選擇的相同會話名稱。 為 traceFile.etl 追蹤檔案選擇適當的名稱。

以下是開發人員命令提示字元視窗中一般 vcperf.exe 命令順序的外觀：

Screenshot of a command window showing vcperf.exe commands and results.

關於 vcperf.exe 的重要注意事項

  • 需要管理員istrator 許可權，才能啟動或停止 vcperf.exe 追蹤。 使用您使用 [以系統管理員 身分 執行] 開啟的開發人員命令提示字元視窗。

  • 一次只能執行一個追蹤會話。

  • 請務必記住您用來啟動追蹤的會話名稱。 在不知道其名稱的情況下，停止執行中的會話可能會很麻煩。

  • 就像 cl.exe 和 link.exe 一樣 ，命令列公用程式 vcperf.exe 包含在 MSVC 安裝中。 不需要額外的步驟，才能取得此元件。

  • vcperf.exe 會收集系統上執行的所有 MSVC 工具相關資訊。 因此，您不需要從用來收集追蹤的相同命令提示字元啟動組建。 您可以從不同的命令提示字元，甚至是在 Visual Studio 中建置專案。

vcperf.exe 是開放原始碼

如果您想要建置並執行自己的 vcperf.exe 版本 ，請隨意從 vcperf GitHub 存放庫 複製它。

步驟 3：在 Windows 效能分析器中檢視追蹤

啟動 WPA 並開啟您剛才收集的追蹤。 WPA 應該將其辨識為 C++ Build Insights 追蹤，且下列檢視應該會出現在左側的 [Graph 總管] 面板中：

  • 組建總管
  • Files
  • 函式
  • 範本具現化

如果您看不到這些檢視，請仔細檢查 WPA 是否已正確設定，如步驟 1 中所述 。 您可以將檢視拖曳到右側的空白 [分析] 視窗，以檢視組建資料，如下所示：

View of a C++ Build Insights trace in Windows Performance Analyzer.

[圖形總管] 面板提供其他檢視。 當您對包含的資訊感興趣時，將它們拖曳到 [分析] 視窗中。 有用的是 CPU （取樣） 檢視，其會顯示整個組建的 CPU 使用率。

其他相關資訊

教學課程：Windows 效能分析器基本概念
瞭解可協助您分析組建追蹤的常見 WPA 作業。

參考：vcperf 命令
vcperf.exe 命令參考會列出所有可用的命令選項。

參考：Windows 效能分析器檢視
如需 WPA 中 C++ Build Insights 檢視的詳細資料，請參閱這篇文章。

Windows Performance Analyzer
官方 WPA 檔網站。