Installare interpreti Python

Sono disponibili diverse opzioni per l'installazione di interpreti Python per l'uso con Visual Studio. È possibile installare un interprete quando si installa il carico di lavoro Python oppure è possibile installare un interprete dopo che è presente un carico di lavoro. Gli interpreti possono anche essere installati manualmente all'esterno del Programma di installazione di Visual Studio.

Quando si installa il carico di lavoro sviluppo Python in Visual Studio 2017 e versioni successive, Python 3 (64 bit) viene installato anche per impostazione predefinita. Come opzione, è possibile scegliere di installare la versione a 32 bit o a 64 bit di Python 2 o Python 3, insieme a Miniconda (Visual Studio 2019) o Anaconda 2/Anaconda 3 (Visual Studio 2017). I passaggi per questo tipo di installazione sono descritti in Installare il supporto python in Visual Studio.

Un approccio alternativo consiste nell'installare interpreti Python standard usando la funzionalità Aggiungi ambiente in Visual Studio. Questa opzione è disponibile nella finestra Ambienti Python e nella barra degli strumenti python.

Gli interpreti Python possono anche essere installati manualmente all'esterno del Programma di installazione di Visual Studio. Si supponga di installare Anaconda 3 prima di installare Visual Studio. Non è necessario reinstallare Anaconda tramite il Programma di installazione di Visual Studio. È anche possibile installare una versione più recente di un interprete se non è ancora elencata nella Programma di installazione di Visual Studio.

Prerequisiti

  • Visual Studio supporta Python versione 3.7. Sebbene sia possibile usare una versione precedente di Visual Studio per modificare il codice scritto nelle versioni precedenti di Python, tali versioni di Python non sono ufficialmente supportate. Le funzionalità di Visual Studio, ad esempio IntelliSense e il debug, potrebbero non funzionare con le versioni precedenti di Python.

  • Per Visual Studio 2015 e versioni precedenti, usare Python 3.5 o versioni precedenti. È necessario installare manualmente uno degli interpreti Python.

Distribuzioni di Anaconda

Anche se Visual Studio offre di installare la distribuzione di Anaconda, l'uso della distribuzione e di altri pacchetti dal repository Anaconda è associato alle condizioni per il servizio Anaconda. Queste condizioni potrebbero richiedere ad alcune organizzazioni di pagare Anaconda per una licenza commerciale oppure configurare gli strumenti per accedere a un repository alternativo. Per altre informazioni, vedere la documentazione dei canali Conda.

Esaminare gli interpreti Python

La tabella seguente elenca gli interpreti Python che possono essere usati con Visual Studio.

Interprete Descrizione Note
CPython Interprete "nativo" e più comunemente usato, disponibile nelle versioni a 32 bit e a 64 bit (consigliato a 32 bit). Include le funzionalità più recenti del linguaggio e offre la massima compatibilità con i pacchetti Python, nonché il supporto completo per il debug e l'interoperabilità con IPython. Esaminare le considerazioni in Usare Python 2 o Python 3? per determinare quale versione di Python installare. Visual Studio 2015 e versioni precedenti non supportano Python 3.6 o versione successiva e possono restituire errori come Python non supportato versione 3.6. Per Visual Studio 2015 e versioni precedenti, usare Python 3.5 o versioni precedenti.
IronPython Implementazione .NET di Python, disponibile nelle versioni a 32 bit e a 64 bit. Fornisce l'interoperabilità C#/F#/Visual Basic, l'accesso alle API .NET, il debug Python standard (ma non il debug in modalità mista C++) e il debug misto IronPython/C#. IronPython non supporta gli ambienti virtuali.
Anaconda Una piattaforma open data science basata su Python. Include la versione più recente di CPython e la maggior parte dei pacchetti difficili da installare. Se non si riesce a decidere su un interprete, è consigliabile usare Anaconda.
PyPy Implementazione JIT di traccia ad alte prestazioni di Python. Valido per programmi e situazioni a esecuzione prolungata in cui si identificano i problemi di prestazioni, ma non è possibile trovare altre soluzioni. Funziona con Visual Studio, ma offre supporto limitato per le funzionalità avanzate di debug.
Jython Implementazione di Python in Java Virtual Machine (JVM). Analogamente a IronPython, il codice in esecuzione in Jython può interagire con le classi e le librerie Java. Tuttavia, molte delle librerie destinate a CPython potrebbero non essere accessibili. Funziona con Visual Studio, ma offre supporto limitato per le funzionalità avanzate di debug.

Rilevare l'ambiente

Visual Studio mostra tutti gli ambienti noti nella finestra Ambienti Python. Rileva automaticamente gli aggiornamenti agli interpreti esistenti.

Se Visual Studio non rileva un ambiente installato, vedere Identificare manualmente un ambiente esistente.

Per fornire nuove forme di rilevamento per gli ambienti Python, vedere PtVS Environment Detection (github.com).

Voci del Registro di sistema

Visual Studio, in tutte le versioni, rileva automaticamente ogni interprete Python installato e il relativo ambiente controllando il Registro di sistema secondo quanto descritto in PEP 514 - Python registration in the Windows registry (PEP 514 - Registrazione di Python nel Registro di sistema di Windows). Le installazioni python sono in genere disponibili nella chiave HKEY_LOCAL_MACHINE\SOFTWARE\Python (32 bit) e HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python (64 bit) all'interno dei nodi per la distribuzione, ad esempio PythonCore (CPython) e ContinuumAnalytics (Anaconda).

Spostare un interprete

Se si sposta un interprete esistente in una nuova posizione usando il file system, Visual Studio non rileva automaticamente la modifica.

  • Se in origine è stata specificata la posizione dell'interprete tramite la finestra Ambienti Python, è possibile modificarne l'ambiente usando la scheda Configura in tale finestra per identificare la nuova posizione. Per altre informazioni, vedere Identificare manualmente un ambiente esistente.

  • Se l'interprete è stato installato usando un programma di installazione, seguire questa procedura per reinstallare l'interprete nel nuovo percorso:

    1. Ripristinare l'interprete Python nel percorso originale.
    2. Disinstallare l'interprete usando il relativo programma di installazione, che cancella le voci del Registro di sistema.
    3. Reinstallare l'interprete nella nuova posizione.
    4. Riavviare Visual Studio, che dovrebbe correggere automaticamente la nuova posizione al posto della posizione precedente.

Questo processo garantisce che le voci del Registro di sistema che identificano il percorso dell'interprete, usate da Visual Studio, vengano aggiornate correttamente. L'uso di un programma di installazione gestisce anche eventuali altri effetti collaterali che potrebbero esistere.