安裝 Python 解譯器

有數個選項可用來安裝 Python 解釋器以使用 Visual Studio。 您可以在安裝 Python 工作負載時安裝解釋器,或在工作負載存在之後安裝解釋器。 解釋器也可以在 Visual Studio 安裝程式 之外手動安裝。

當您在 Visual Studio 2017 和更新版本中安裝 Python 開發工作負載時,Python 3 (64 位) 預設也會安裝。 您可以選擇安裝 32 位或 64 位版本的 Python 2 或 Python 3,以及 Miniconda (Visual Studio 2019) 或 Anaconda 2/Anaconda 3 (Visual Studio 2017)。 在 Visual Studio 中安裝 Python 支援中說明這種類型的安裝步驟。

替代方法是使用 Visual Studio 中的 [新增環境 ] 功能來安裝標準 Python 解釋器。 此選項可在 [Python 環境] 視窗和 [Python] 工具列中使用。

Python 解釋器也可以在 Visual Studio 安裝程式 之外手動安裝。 假設您在安裝 Visual Studio 之前安裝 Anaconda 3。 您不需要透過 Visual Studio 安裝程式 重新安裝 Anaconda。 如果尚未列在 Visual Studio 安裝程式 中,您也可以安裝較新版本的解釋器。

必要條件

  • Visual Studio 支援 Python 3.7 版。 雖然可以使用舊版 Visual Studio 來編輯以舊版 Python 撰寫的程式代碼,但不支援這些版本的 Python。 IntelliSense 和偵錯等 Visual Studio 功能可能無法與舊版 Python 搭配運作。

  • 針對 Visual Studio 2015 和更早版本,請使用 Python 3.5 或更早版本。 您必須手動安裝其中一個 Python 解釋器。

Anaconda 散發套件

雖然 Visual Studio 提供安裝 Anaconda 散發套件,但您從 Anaconda 存放庫使用散發套件和其他套件是由 Anaconda 服務條款所系結。 這些條款可能需要某些組織支付 Anaconda 的商業授權費用,或設定工具來存取替代存放庫。 如需詳細資訊,請參閱 Conda 通道檔

檢閱 Python 解釋器

下表列出可與 Visual Studio 搭配使用的 Python 解釋器。

解譯器 描述 附註
CPython 這是「原生」且最常用的解譯器,提供 32 位元和 64 位元版本 (建議使用 32 位元)。 包含最新的語言功能、最大的 Python 套件相容性、完整的偵錯支援,以及與 IPython 的互通性。 檢閱我是否應該使用 Python 2 或 Python 3? 中的考慮,以協助判斷要安裝的 Python 版本。 Visual Studio 2015 和更早版本不支援 Python 3.6 或更新版本,而且可能會傳回錯誤,例如 不支援的 Python 3.6 版。 針對 Visual Studio 2015 和更早版本,請使用 Python 3.5 或更早版本。
IronPython Python 的 .NET 實作,適用於 32 位和 64 位版本。 提供 C#/F#/Visual Basic Interop、存取 .NET API、標準 Python 偵錯(但不是 C++ 混合模式偵錯),以及混合 IronPython/C# 偵錯。 IronPython 不支援虛擬環境。
Anaconda 由 Python 提供之開放式數據科學平臺。 包含最新版的 CPython 和大部分難以安裝的套件。 如果您無法決定解釋器,建議您使用 Anaconda。
PyPy Python 的高效能追蹤 JIT 實作。 適用於長時間執行的程式和您識別效能問題但找不到其他解決方案的情況。 可以與 Visual Studio 搭配運作,但對進階偵錯功能的支援有限。
Jython 「Java 虛擬機器」(JVM) 上的 Python 實作。 類似於 IronPython,在 Jython 中執行的程式碼可以與 JAVA 類別和程式庫互動。 不過,許多適用於 CPython 的連結庫可能無法存取。 可以與 Visual Studio 搭配運作,但對進階偵錯功能的支援有限。

偵測您的環境

Visual Studio 會在 [Python 環境] 視窗中顯示所有已知的環境。 它會自動偵測現有解釋器的更新。

如果 Visual Studio 未偵測到已安裝的環境,請參閱 手動識別現有的環境

如果您想要為 Python 環境提供新的偵測形式,請參閱 PTVS 環境偵測 (github.com)。

登錄項目

Visual Studio (所有版本) 會根據 PEP 514 - Python registration in the Windows registry (PEP 514 - Windows 登錄中的 Python 註冊) 檢查登錄,以自動偵測每個安裝的 Python 解譯器與其環境。 Python 安裝通常位於 HKEY_LOCAL_MACHINE\SOFTWARE\Python (32 位) 和 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python (64 位) 密鑰的節點內,以供散發使用,例如 PythonCore (CPython) 和 ContinuumAnalytics (Anaconda)。

移動解譯器

如果您使用文件系統將現有的解釋器移至新位置,Visual Studio 不會自動偵測變更。

  • 如果您原本透過 [Python 環境] 視窗指定解釋器的位置,您可以使用該視窗中的 [設定] 索引標籤來編輯其環境,以識別新的位置。 如需詳細資訊,請參閱 手動識別現有的環境

  • 如果您使用安裝程式安裝解釋器,請使用下列步驟在新位置重新安裝解釋器:

    1. 將 Python 解譯器還原到其原始位置。
    2. 使用其安裝程式來卸載解釋器,以清除登錄專案。
    3. 在新位置重新安裝解譯器。
    4. 重新啟動 Visual Studio,如此應該會自動偵測新位置來取代舊位置。

此程式可確保識別 Visual Studio 所使用的解釋器位置的登錄專案已正確更新。 使用安裝程式也會處理可能存在的任何其他副作用。