Usare le cartelle Python nei percorsi di ricerca di Visual Studio

In un programma Python tipico, la PYTHONPATH variabile di ambiente (o IRONPYTHONPATHe così via) fornisce il percorso di ricerca predefinito per i file di modulo. Le from <name> import... istruzioni o import <name> indicano a Python di cercare nei percorsi specifici i file che corrispondono all'oggetto specificato <name>. Le posizioni vengono cercate nell'ordine seguente:

1. Moduli predefiniti python
2. Cartella che contiene il codice Python attualmente in esecuzione
3. Il "percorso di ricerca del modulo" come definito dalla variabile di ambiente applicabile .Per altre informazioni, vedere Il percorso di ricerca del modulo e le variabili di ambiente nella documentazione di Base di Python.

Visual Studio ignora la variabile di ambiente del percorso di ricerca, anche quando la variabile è impostata per l'intero sistema. Il motivo è che l'uso della variabile genera domande che non possono essere facilmente risposte, ad esempio:

• I moduli a cui si fa riferimento prevedono un'installazione di Python 2.7, Python 3.6 o un'altra versione?
• I file trovati nella variabile di ambiente del percorso di ricerca eseguono l'override dei moduli della libreria standard?
• È previsto e risolto un comportamento di override o l'azione potrebbe essere dannosa?

Per aiutare gli sviluppatori, Visual Studio offre un modo per specificare i percorsi di ricerca direttamente in ambienti e progetti Python. Il codice eseguito o di debug in Visual Studio riceve i percorsi di ricerca dalla variabile di ambiente e dalla PYTHONPATH variabile equivalente. Aggiungendo percorsi di ricerca, Visual Studio esamina le librerie nei percorsi specificati e compila i database IntelliSense per le librerie in base alle esigenze. In Visual Studio 2017 versione 15.5 e precedenti la costruzione del database può richiedere del tempo a seconda del numero di librerie.

Prerequisiti

• Visual Studio. Per installare il prodotto, seguire la procedura descritta in Installare Visual Studio.

• Cartelle Python da aggiungere ai percorsi di ricerca.

Aggiungere cartelle Python ai percorsi di ricerca

Seguire questa procedura per aggiungere una cartella Python ai percorsi di ricerca di Visual Studio:

1. In Esplora soluzioni espandere il nodo del progetto Python, fare clic con il pulsante destro del mouse su Percorsi di ricerca e scegliere Aggiungi cartella al percorso di ricerca:

   

2. Nella finestra di dialogo passare al percorso della cartella da aggiungere ai percorsi di ricerca riconosciuti.

3. Selezionare la cartella e quindi scegliere Seleziona cartella.

Dopo l'aggiunta delle cartelle ai percorsi di ricerca, Visual Studio usa tali percorsi per qualsiasi ambiente associato al progetto.

Nota

Se l'ambiente è basato su Python 3 e si tenta di aggiungere un percorso di ricerca ai moduli Python 2.7, potrebbero verificarsi errori.

Aggiungere file ZIP e egg per cercare i percorsi

È possibile aggiungere file con un'estensione .zip o .egg ai percorsi di ricerca con l'opzione Aggiungi archivio ZIP al percorso di ricerca. Come con le cartelle, il contenuto di questi file viene analizzato e reso disponibile per IntelliSense.

Contenuto correlato

• Gestire ambienti Python in Visual Studio
• Selezionare un interprete per un progetto
• Usare requirements.txt per le dipendenze
• Informazioni di riferimento sulla finestra Ambienti Python