Opzioni per Python in Visual Studio

Visual Studio offre supporto per la configurazione dell'ambiente di sviluppo interattivo (IDE) per lo sviluppo Python. È possibile impostare le opzioni in base alle proprie preferenze e soddisfare esigenze specifiche dell'ambiente di sviluppo. Questo articolo descrive le opzioni disponibili per il layout e il comportamento generali, il debug, la diagnostica e le funzionalità avanzate del linguaggio Python.

Posizione delle opzioni di Python

Le impostazioni di configurazione di Python sono disponibili dalla barra degli strumenti di Visual Studio in Opzioni strumenti>. La finestra di dialogo Opzioni elenca la maggior parte delle impostazioni per Python nella scheda Python :

È possibile configurare le preferenze per il debug, l'analisi del server del linguaggio Pylance, gli ambienti conda, l'ambiente generale e Interactive Windows.

Nella finestra di dialogo Opzioni sono elencate altre impostazioni Python sotto Editor di testo>Python. Sono disponibili opzioni per barre di scorrimento, schede e formattazione, insieme alle impostazioni generali e avanzate. Altre impostazioni sono disponibili inTipi di carattere e colori> per il gruppo di impostazioni editor di testo.

Annotazioni

La finestra di dialogo Opzioni può includere una scheda o un gruppo sperimentale per le funzionalità in fase di sviluppo che non sono descritte in questo articolo. Per altre informazioni, vedere i post sulla progettazione python nel blog di Microsoft.

Opzioni specifiche per Python

InOpzioni>strumenti>Python è possibile impostare opzioni specifiche di Python per l'ambiente generale, tra cui Interactive Windows, ambienti conda, debug e altro ancora.

Opzioni generali di Python

Leopzioni seguenti sono disponibili in>>strumenti>Python Generale:

Opzione	Predefinito	Description
Visualizzare la finestra di output durante la creazione di ambienti virtuali	Attivato	Deselezionare per impedire la visualizzazione della finestra Output .
Visualizzare la finestra di output durante l'installazione o la rimozione di pacchetti	Attivato	Deselezionare per impedire la visualizzazione della finestra Output .
Visualizzare la barra delle notifiche per creare ambienti	Attivato	Quando si configura e si apre un progetto con un file requirements.txt o environment.yml, Visual Studio mostra una barra informativa con suggerimenti per creare un ambiente virtuale o, rispettivamente, un ambiente conda anziché usare l'ambiente globale predefinito.
Visualizzare la barra delle notifiche per installare i pacchetti	Attivato	Quando si imposta e si apre un progetto con un file direquirements.txt che non usa l'ambiente globale predefinito, Visual Studio confronta tali requisiti con i pacchetti installati nell'ambiente corrente. Se mancano pacchetti, Visual Studio visualizza un prompt per installare tali dipendenze.
Visualizzare la barra delle notifiche per configurare il framework di test	Attivato	Se impostato, se Visual Studio rileva i file nel progetto Python che potrebbero contenere test ma non è abilitato alcun framework di test, Visual Studio richiede di abilitare pytest o unittest.
Eseguire sempre gli strumenti di gestione pacchetti come amministratore	Disattivato	Eleva sempre le operazioni di gestione pacchetti come pip install e simili per tutti gli ambienti. Quando si installano pacchetti, Visual Studio richiede privilegi di amministratore se l'ambiente si trova in un'area protetta del file system, ad esempio c:\Programmi. In questo prompt è possibile scegliere di elevare sempre il comando di installazione per un solo ambiente. Per altre informazioni, vedere scheda Pacchetti.

Opzioni dell'ambiente Conda

Le opzioni seguenti sono disponibili inOpzioni>strumenti>Python>Conda:

Opzione	Predefinito	Description
Percorso eseguibile conda	(vuoto)	Specifica un percorso esatto del file eseguibile conda.exe anziché basarsi sull'installazione miniconda predefinita inclusa nel carico di lavoro Python. Se viene specificato un altro percorso, ha la precedenza sull'installazione predefinita e su qualsiasi altro eseguibile conda.exe specificato nel Registro di sistema. È possibile modificare questa impostazione se si installa manualmente una versione più recente di Anaconda o Miniconda o si vuole usare una distribuzione a 32 bit anziché la distribuzione a 64 bit predefinita.

Opzioni di debug

Le opzioni seguenti sono disponibili in Strumenti>Opzioni>debug>:

Opzione	Predefinito	Description
Richiedi conferma prima dell'esecuzione quando sono presenti errori	Attivato	Quando questa opzione è impostata, Visual Studio chiede di confermare che si vuole eseguire codice con errori. Per disabilitare l'avviso, deselezionare questa opzione.
Attendere l'input quando il processo viene chiuso in modo anomalo Attendere l'input quando il processo viene chiuso normalmente	Attivato (per entrambi)	Un programma Python avviato da Visual Studio viene eseguito nella propria finestra della console. Per impostazione predefinita, la finestra attende di premere un tasto prima di chiuderla indipendentemente dalla modalità di uscita del programma. Per rimuovere il prompt e chiudere automaticamente la finestra, deselezionare una o entrambe queste opzioni.
Output del programma tee nella finestra Debug output	Attivato	Visualizza l'output del programma sia in una finestra della console separata che nella finestra Output di Visual Studio. Deselezionare questa opzione per visualizzare l'output solo nella finestra della console separata.
Interruzione dell'eccezione SystemExit con codice di uscita pari a zero	Disattivato	Se impostato, arresta il debugger in questa eccezione. Quando è chiaro, il debugger esce senza interruzioni.
Abilitare il debug della libreria standard Python	Disattivato	Permette di entrare nel codice sorgente della libreria standard durante il debug, ma aumenta il tempo necessario per l'avvio del debugger.
Mostra valore restituito della funzione	Attivato	Visualizza i valori restituiti dalla funzione nella finestra Variabili locali e quindi esegue l'esecuzione di una chiamata di funzione nel debugger (F10)
Mostra variabili	Attivato	Visualizza quattro gruppi di variabili da visualizzare e come formattare la visualizzazione (Gruppo, Nascondi, Inline). - Classe: il valore predefinito è "Group" - Protetto: il valore predefinito è Inline" - Funzione: il valore predefinito è "Group" - Speciale: il valore predefinito è "Group"

Opzioni di analisi

Le opzioni seguenti sono disponibili in Strumenti>Opzioni>Python>Analysis:

Opzione	Predefinito	Description
Modalità diagnostica	Apri solo file	Specifica quali file di codice il server linguistico analizza per problemi, inclusi Workspace e solo file aperti.
Livello di log	Informazioni	Specifica il livello di registrazione da eseguire dal server di lingua. I possibili livelli di registrazione, nell'aumento del livello di informazioni fornite, includono Errore, Avviso, Informazioni e Traccia.
Controllo dei tipi	Disattivato	Specifica il livello di analisi da eseguire per il controllo dei tipi: - Off: produrre la diagnostica delle importazioni/variabili non risolte, ma non eseguire l'analisi di controllo del tipo - Basic: usa regole non di tipo (tutte le regole al livello Off) e anche regole di base relative al controllo dei tipi - Strict: utilizzare tutte le regole di controllo dei tipi alla massima severità dell'errore, incluse tutte le regole presenti in entrambi i livelli Off e Basic
Formato di importazione	Assoluto	Definisce il formato predefinito durante l'importazione automatica dei moduli, incluso Assoluto o Relativo.
Percorsi stub	<Vuoto>	Specifica un percorso per una directory contenente stub di tipo personalizzato. I file stub di tipo per ogni pacchetto devono trovarsi nella propria sottodirectory.
Percorsi di ricerca	<Vuoto>	Specifica i percorsi di ricerca per la risoluzione dell'importazione. Accetta i percorsi specificati come stringhe e separati da virgole se sono presenti più percorsi, ad esempio ["path 1","path 2"].
Percorsi tipificati	<Vuoto>	Specifica i percorsi per Visual Studio per utilizzare file Typeshed personalizzati invece della versione in bundle.
Aggiungere automaticamente percorsi di ricerca comuni come "src"	Attivato	Indica se aggiungere automaticamente i percorsi di ricerca in base a nomi predefiniti, ad esempio src.
Indicizzare le librerie di terze parti installate e i file utente per funzionalità del linguaggio come l'importazione automatica, l'aggiunta di importazioni, simboli dell'area di lavoro e così via.	Disattivato	Specifica se il server di linguaggio deve indicizzare i file utente e installare librerie di terze parti all'avvio. L'indice fornisce un set più completo di simboli nelle funzionalità, tra cui importazioni automatici, correzioni rapide, completamenti automatici e così via. - Quando impostato, Visual Studio indicizza i simboli di primo livello dei pacchetti installati, come i simboli in all sotto package/__init__.py, insieme a tutti i simboli provenienti da un massimo di 2.000 file utente. - Quando non è impostato, Visual Studio visualizza i simboli a cui si fa riferimento o usati nei file aperti in precedenza o caricati dall'editor.

Opzioni interattive di Windows

Leopzioni seguenti sono disponibili in>>strumenti> PythonInteractive Windows:

Opzione	Predefinito	Description
script	non disponibile	Specifica una cartella generale per gli script di avvio da applicare a Interactive Windows per tutti gli ambienti. Per altre informazioni, vedere Script di avvio. Nota: questa funzionalità potrebbe non funzionare nella versione di Visual Studio.
Le frecce su/giù esplorano la cronologia	Attivato	Usa i tasti di direzione per spostarsi nella cronologia nella finestra interattiva. Cancella questa impostazione per usare i tasti freccia per navigare all'interno dell'output della finestra interattiva.
Modalità di completamento	Valuta solo le espressioni senza chiamate di funzione	Il processo di determinazione dei membri disponibili in un'espressione nella finestra interattiva potrebbe richiedere la valutazione dell'espressione corrente non completata, che può comportare effetti collaterali o funzioni chiamate più volte. L'impostazione predefinita, valuta solo le espressioni senza chiamate di funzione esclude espressioni che sembrano chiamare una funzione, ma valuta altre espressioni. Ad esempio, valuta l'istruzione a.b ma non l'istruzione a().b . Non valutare mai le espressioni impedisce tutti gli effetti collaterali, usando solo il normale motore IntelliSense per i suggerimenti. Valutare tutte le espressioni valuta l'espressione completa per ottenere suggerimenti, indipendentemente dagli effetti collaterali.
Nascondere i suggerimenti per l'analisi statica	Disattivato	Se impostata, visualizza solo i suggerimenti ottenuti valutando l'espressione. Se combinato con il valore Modalità completamentoMai valuta le espressioni, nella finestra interattiva non vengono visualizzati completamenti utili.

Opzioni dell'editor di testo per Python

In Editor> di testoPython sono disponibili opzioni per barre di scorrimento, schede e formattazione, insieme alle impostazioni generali e avanzate:

Opzioni generali dell'editor Python

Le opzioni seguenti sono disponibili in Strumenti>Opzioni>Editor> di testoPython>Generale:

Opzione	Predefinito	Description
Membri dell'elenco automatico	Attivato	Impostare questa opzione per elencare automaticamente i membri per il completamento delle istruzioni di codice.
Nascondi membri avanzati	Attivato	Quando l'opzione Auto elenco membri è abilitata, imposti questa opzione per nascondere i membri avanzati dai suggerimenti di completamento automatico. I membri avanzati sono membri usati meno frequentemente di altri.
Informazioni sui parametri	Attivato	Se impostato, il passaggio del mouse sui parametri mostra informazioni dettagliate, ad esempio la definizione dell'elemento e i collegamenti alla documentazione.
Abilitare lo spazio virtuale	Attivato	Se impostato, inserisce spazi alla fine di ogni riga di codice. Selezionare questa opzione per posizionare i commenti in un punto coerente accanto al codice. La modalità Spazio virtuale è abilitata in modalità Selezione colonne . Quando la modalità Spazio virtuale non è abilitata, il punto di inserimento passa dalla fine di una riga direttamente al primo carattere della riga successiva. Nota: questa opzione è influenzata dall'impostazione globale Editor di testo>Tutti i linguaggi>Generale>Abilita spazio virtuale. Se l'impostazione globale non è abilitata, questa opzione non può essere abilitata a livello di lingua.
Ritorno a capo automatico	Disattivato	Impostare questa opzione per consentire il wrapping di righe lunghe di codice in base alla larghezza del riquadro di visualizzazione degli editor.
Mostra indicatori visivi per l'a capo	Disattivato	Quando l'opzione interruzione automatica di riga è abilitata, impostare questa opzione per visualizzare glifi.
Numeri di riga	Disattivato	Impostare questa opzione per visualizzare i numeri di riga nel margine sinistro dell'editor per ogni riga di codice.
Abilitare lo spostamento con URL a clic singolo	Attivato	Se impostato, è possibile fare clic su un URL per passare alla posizione di destinazione.
Barra di navigazione	Disattivato	Impostare questa opzione per abilitare le caselle a discesa nella parte superiore della finestra del codice. Questi campi consentono di passare al codice in una codebase in cui è possibile scegliere un tipo o un membro a cui passare direttamente. Nota: questa opzione è influenzata dall'impostazione globale dell'editor>di testo> Generale>Abilita barra di navigazione. Per altre informazioni, vedere Navigare nel codice> barra di navigazione.
Completamento automatico parentesi graffa	Attivato	Quando impostato, Visual Studio aggiunge automaticamente la parentesi graffa di chiusura per qualsiasi parentesi graffa aperta durante l'immissione del codice.
Applica taglia o copia a righe vuote quando non è presente alcuna selezione	Attivato	Per impostazione predefinita, Visual Studio taglia o copia l'intera riga di codice quando non è presente alcuna selezione esplicita. Utilizzare questa opzione per abilitare o disabilitare questo comportamento taglia o copia quando viene richiamato su righe vuote.

Per altre informazioni, vedere La finestra di dialogo Opzioni: Editor > di testo Generale.

Opzioni avanzate dell'editor Python

Le opzioni seguenti sono disponibili in Strumenti>Opzioni>Editor> di testoPython>Avanzate:

Opzione	Predefinito	Description
Offri completamenti automatici delle importazioni	Attivato	Se impostato, Visual Studio offre importazioni automatiche nelle opzioni di completamento.
Aggiungere automaticamente parentesi quadre per le funzioni	Disattivato	Quando impostato, Visual Studio aggiunge automaticamente parentesi quadre per le funzioni durante l'immissione del codice nell'editor.

Opzioni tipi di carattere e colori

Altre opzioni python sono disponibili inTipi di carattere e colori> quando il gruppo Editor di testo è impostato su Python:

I nomi delle opzioni python sono tutti preceduti da "Python" e sono autoesplicativi. Il tipo di carattere predefinito per tutti i temi colore di Visual Studio è normale 10 pt Consolas (non in grassetto). I colori predefiniti variano in base al tema. In genere, si modifica un tipo di carattere o un colore per semplificare la lettura del testo.