在 Visual Studio 中分析 Python 程式碼

當您對程式碼進行偵錯時，Visual Studio 會提供 Python 應用程式的分析功能。 Visual Studio 偵錯工具可讓您逐步執行程式碼，以檢查變數、分析程式狀態、解決潛在問題等等。 Visual Studio 分析功能會提供有關程式執行時間的資訊。 可以使用此資訊來協助識別程式碼中的效能問題。

當您使用 CPython 型解譯器時，分析適用於 Python 3.9 和更早版本。

必要條件

• 已在 Windows 中安裝 Visual Studio 並支援 Python 工作負載。 如需詳細資訊，請參閱在 Visual Studio 中安裝 Python 支援。

• CPython 型解譯器。 CPython 是「原生」且最常用的解譯器，提供 32 位元和 64 位元版本 (建議使用 32 位元)。 如需詳細資訊，請參閱安裝 Python 解譯器。

• 具有程式碼的 Python 專案，或具有 Python 程式碼的資料夾。

不支援 Visual Studio for Mac。 如需詳細資訊，請參閱 Visual Studio for Mac 發生什麼事？ Windows、Mac 和 Linux 上的 Visual Studio Code 可透過可用的延伸模組與 Python 搭配運作。

搭配使用分析工具與 CPython 型解譯器

當您分析 Python 應用程式時，Visual Studio 會收集程式存留期的資料，時間單位為毫秒 (ms)。

請遵循下列步驟，在 Visual Studio 中開始使用分析功能：

1. 在 Visual Studio 中，開啟 Python 程式碼檔案。

2. 確認 Python 程式碼的目前環境是 CPython 型解譯器。 您可以在 [Python 環境] 視窗中檢查選取的解譯器。

3. 在主要工具列中，選取 [偵錯]>[啟動 Python 分析]。 Visual Studio 會開啟 [分析設定] 對話方塊：

   

4. 在 [分析設定] 對話方塊中，選擇您要分析的程式碼檔案或專案程式碼：

   • 若要分析所有專案程式碼：

     1. 選取 [開啟專案]。

     2. 從下拉式清單中選取專案。 此清單會顯示目前 Visual Studio 解決方案中的所有專案。

   • 若要分析特定檔案：

     1. 選取 [獨立指令碼]。

     2. 從下拉式清單中選取 [Python 解譯器]，或瀏覽至位置。 若要指定未列出的解譯器，請選擇下拉式清單中的 [其他]，然後指定 [解譯器路徑]。

     3. 識別 [指令碼] 檔案或瀏覽至位置。

     4. 指定 [工作目錄] 或瀏覽至位置。

     5. 指定指令碼的任何命令列引數。

5. 選取 [開始]。

分析工具會在 Visual Studio 中執行並開啟效能報告。 您可以檢閱報告，以探索應用程式所花費的時間：

搭配使用分析工具與 IronPython

IronPython 是 Python 的 .NET 實作，適用於 32 位元和 64 位元版本。 IronPython 不是 CPython 型解譯器。 Visual Studio 支援 IronPython 的標準 Python 偵錯，但不支援分析功能。

針對 IronPython 專案，您可以使用 Visual Studio .NET 分析工具。 使用適當的引數直接作為目標應用程式來執行 ipy.exe 命令，以啟動您的啟動指令碼。 將 -X:Debug 引數包含在命令列中，以確保可偵錯與分析您的所有 Python 程式碼。 此引數會產生效能報告，它包含 IronPython 執行階段及程式碼所花費的時間。 使用損壞的名稱來識別程式碼。

IronPython 提供一些內建分析，但目前沒有可運作的可視化工具。 如需詳細資訊，請參閱 IronPython 文件中的 IronPython 分析工具 (部落格) 和偵錯和分析。

相關內容

• 安裝 Python 解譯器
• 教學課程：在 Visual Studio 的偵錯工具中執行程式碼