共用方式為


教學課程: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 檔網站。