Configurare VSCode per Python: guida completa

Perché usare VSCode per Python?

Virtual Studio Code (VSCode) è un IDE perfetto per Python. È semplice e include funzionalità integrate che migliorano l’esperienza di sviluppo. Le estensioni Python per VSCode offrono funzioni potenti come completamento automatico della sintassi, linting, debugging, unit test, GitOps, ambienti virtuali, notebook, strumenti di editing e la possibilità di personalizzare l’editor.  

Funzionalità principali:

1. Command Palette per accedere a tutti i comandi digitando parole chiave.
2. Scorciatoie da tastiera completamente personalizzabili.
3. Estensione Jupyter per la data science. Esegui notebook Jupyter all’interno dell’IDE.
4. Linting e formattazione automatici.
5. Debug e test.
6. Integrazione con Git.
7. Snippet di codice personalizzati.
8. Strumenti di editing avanzati. Selezione multi-cursore, selezione per colonna, vista struttura, anteprima affiancata e cerca e modifica.

In questo tutorial installeremo Python e VSCode, quindi eseguiremo uno script Python in VSCode. Dopo, personalizzeremo l’editor per migliorare l’esperienza di sviluppo in Python installando estensioni essenziali e imparando le funzionalità integrate. Infine, vedremo alcuni trucchi per aumentare la produttività in Python. 

Configurazione di Python e Visual Studio Code

In questa parte impareremo a installare Python e VSCode ed eseguire un semplice codice Python. 

Installare Python

Scaricare e installare l’ultima versione di Python è semplice. Vai su Python.org e scarica la versione più recente per Windows. L’installer è disponibile anche per Linux/Unix, macOS e altre piattaforme. Dopo aver scaricato l’installer, installa Python con le impostazioni predefinite.          

Immagine da Python.org

Il modo più diffuso per installare Python è tramite Anaconda Distribution. Include pacchetti e software preinstallati per iniziare a programmare senza intoppi. È disponibile per i sistemi operativi Windows, macOS e Linux. 

Immagine da Anaconda

Dopo aver installato Python sul sistema operativo, verifica che funzioni correttamente digitando il seguente comando nel CLI / Terminale.

python --version

Output:

Python 3.9.13

Altri metodi di installazione di Python

Possiamo anche installare Python usando vari strumenti CLI o tramite il Microsoft Store di Windows. 

• Windows Store
• Homebrew
• Winget
• Chocolatey Software
• apt-get

Puoi consultare la nostra guida completa su come installare Python per maggiori dettagli. Allo stesso modo, il nostro corso interattivo Introduzione a Python ti aiuta a padroneggiare le basi della sintassi Python, liste, funzioni, pacchetti e Numpy.

Installare VSCode

Installare VSCode è semplicissimo. Scarica e installa la build stabile dal sito ufficiale. L’installer è disponibile per tutti i tipi di sistemi operativi, inclusi i browser web. 

Immagine da Visual Studio Code

Altri metodi di installazione di VSCode

Possiamo installarlo usando Microsoft Store, Snap Store e diversi strumenti CLI per Windows, Linux e macOS. 

• Winget
• Microsoft Store
• Chocolatey Software
• Scoop
• Homebrew
• Snap Store
• APT

Eseguire Python in VSCode

Dopo aver installato Python e VSCode, è il momento di scrivere un codice semplice ed eseguire il file Python all’interno dell’IDE. 

Crea un nuovo file 

All’avvio vedrai una schermata di benvenuto. Ignorala e vai su File > Nuovo file di testo oppure usa la scorciatoia Ctrl + N per creare un nuovo file. Poi scrivi una semplice istruzione print per visualizzare “Hello World”.

Salva il file Python

Salva il file con Ctrl + S. Seleziona la cartella e digita il nome del file. Assicurati di aggiungere `.py` alla fine del nome. 

Seleziona l’interprete 

Per eseguire il file Python, dobbiamo selezionare l’interprete Python. Per impostazione predefinita, l’ambiente Anaconda include Python versione 3.9.13.

Esegui un file Python

Per eseguire il file Python, clicca semplicemente sul pulsante Run in alto a sinistra, come mostrato nell’immagine. Inizializzerà il terminale ed eseguirà il file Python per mostrare l’output. 

Puoi anche digitare python test.py nel terminale per eseguire il file presente nella directory corrente. 

Installare le estensioni Python essenziali per VSCode

Le estensioni Python di VSCode ci forniscono funzionalità utili per l’editing del codice, docstring, linting, formattazione, debugging, test e selezione dell’ambiente. 

Come installare un’estensione VSCode 

Clicca sull’icona a forma di scatola nella barra delle attività o usa la scorciatoia da tastiera: Ctrl + Shift + X per aprire il pannello delle estensioni. Digita una parola chiave nella barra di ricerca per esplorare tutti i tipi di estensioni. 

Installa l’estensione Python per VSCode

Nel nostro caso, digiteremo Python e installeremo l’estensione Python cliccando sul pulsante Installa, come mostrato sopra. 

Elenco delle estensioni Python essenziali 

1. Python

L’estensione Python installa automaticamente le estensioni Pylance, Jupyter e isort. Viene fornita con una raccolta completa di strumenti per Data Science, sviluppo web e ingegneria del software. 

Funzionalità chiave:

L’estensione Python include IntelliSense, linting, debugging, navigazione del codice, formattazione del codice, refactoring, esplorazione delle variabili e test explorer.

• IntelliSense (completamento del codice)
• Linting (Pylint, Flake8)
• Formattazione del codice (black, autopep)
• Debugging
• Testing (unittest, pytest)
• Jupyter Notebooks
• Ambienti (venv, pipenv, conda)
• Refactoring 

2. Indent-rainbow

Le estensioni Indent-rainbow forniscono un’indentazione multicolore a più livelli per migliorare la leggibilità del codice. Otteniamo colori alternati a ogni livello, il che aiuta a evitare i comuni errori di indentazione. 

3. Python Indent

L’estensione Python Indent ci aiuta a creare le indentazioni. Premendo il tasto Invio, l’estensione analizzerà il file Python e determinerà come deve essere indentata la riga successiva. Fa risparmiare tempo. 

4. Jupyter Notebook Renderers

Jupyter Notebook Renderers fa parte del pacchetto di estensioni Jupyter. Aiuta a renderizzare output plotly, vega, gif, png, svg e jpeg. 

5. autoDocstring

L’estensione autoDocstring ci aiuta a generare rapidamente docstring per le funzioni Python. Digitando le triple virgolette """ o ''' all’interno della funzione, possiamo generare e modificare la docstring. Scopri di più sulle docstring seguendo il nostro tutorial su Docstring in Python.

Nota: la maggior parte delle estensioni e funzionalità per lo sviluppo in Python sono incluse nell’estensione Python. 

Visual Studio Code Python per la Data Science

Visual Studio Code consente di eseguire in modo semplice il codice di data science in Jupyter Notebook. Possiamo eseguire le celle e visualizzare i risultati all’interno di VSCode. Supporta tutti i linguaggi di programmazione e offre funzionalità integrate per imitare il notebook Jupyter basato su browser che tutti amiamo.

Scopri di più sui Jupyter Notebook leggendo il nostro tutorial Come usare Jupyter Notebook.

Per usare l’estensione Jupyter notebook, dobbiamo prima installare un Jupyter notebook. 

pip install jupyterlab

Oppure 

pip install notebook

Nota: Jupyter Notebook e Jupyter Lab sono inclusi in Anaconda Distribution, quindi non dobbiamo installare nulla. 

Installa l’estensione Jupyter

Dopodiché installa l’estensione Jupyter dal marketplace di Visual Studio. 

Per creare un file Jupyter notebook, possiamo creare un nuovo file con estensione .ipynb oppure aprire la command palette (Ctrl+Shift+P) e selezionare Jupyter: Create New Jupyter Notebook.

Scegli il kernel IPython

Per inizializzare il server Jupyter, dobbiamo selezionare il kernel cliccando sul selettore del kernel in alto a destra del notebook, come mostrato nell’immagine.

Nota: per impostazione predefinita, Anaconda include Python versione 3.9.13. Puoi scaricare l’ultima versione di Python 3.11, ma potrebbe non supportare tutti i pacchetti. 

Esegui la cella Jupyter

Scrivi un’istruzione print per visualizzare “Hello World” e premi il pulsante di esecuzione. 

Aggiungi un’altra cella

Puoi usare il tasto B o cliccare su + Code per aggiungere una nuova cella ed eseguirla con Ctrl + ⤶ Invio. Puoi imparare le scorciatoie da tastiera di Jupyter su defkey.

Per chi usa il linguaggio R, abbiamo un tutorial Notebook per utenti R. Imparerai a usare R in un Jupyter Notebook e funzionalità utili.  

Nota: se cerchi un modo senza pensieri per usare Jupyter Notebook, prova DataLab di DataCamp. Include le librerie Python essenziali, un ambiente preconfigurato e supporta varie integrazioni con database. 

Configurare linting e formattazione in VSCode

Linting

Il linting mette in evidenza i problemi nel codice sorgente Python e fornisce suggerimenti. In genere evidenzia problemi sintattici e stilistici. Il linting ti aiuta a identificare e correggere problemi di codice che possono portare a errori. 

Puoi selezionare il metodo di linting scegliendo Python: Select Linter command nella command palette (Ctrl+Shift+P). Puoi anche abilitare manualmente il metodo di linting nelle impostazioni. 

Seleziona il metodo di linting

Nel nostro caso abbiamo selezionato il metodo flake8. Puoi anche consultare l’elenco dei metodi di linting disponibili.

• Abilita/Disabilita il linting: seleziona Python: Enable/Disable Linting nella command palette. 
• Esegui il linting: command palette (Ctrl+Shift+P) > Python: Run Linting.

Correggere l’errore

Dopo aver eseguito il linter Python, vedrai i problemi con i relativi suggerimenti. 

Nota: abilitare un linter diverso ti chiederà di installare il pacchetto Python richiesto.

Formattazione

La formattazione rende il codice leggibile. Segue regole specifiche per spaziatura tra le righe, indentazioni, spazi attorno agli operatori e parentesi di chiusura. L’estensione Python supporta tre metodi di formattazione: autopep8, black o yapf.

Leggendo PEP-8: convenzioni di denominazione e standard del codice Python, puoi imparare le linee guida di stile e le regole di formattazione di Python.

Seleziona il formatter Python

Per accedere all’opzione di formattazione, apri il pannello delle impostazioni andando su Preferenze -> Impostazioni o usando la scorciatoia: Ctrl +,. Poi digita "python formatting provider" nella barra di ricerca e seleziona "black" dal menu a discesa.

Configura il formatter Python

Per formattare il file Python al salvataggio, cerca format on save nelle Impostazioni e abilita l’opzione Editor: Format on Save.

Strumenti di linting e formattazione più diffusi

Usa questa tabella come riferimento per sapere quali strumenti installare per il tuo caso d’uso.

Debugging e test in VSCode

Debugging

L’estensione Python include il debugging per tutti i tipi di applicazioni, come multi-thread, web e remote. Possiamo impostare breakpoint, ispezionare i dati ed eseguire i programmi passo per passo. 

Seleziona una configurazione di debug

Apri la scheda debug cliccando sull’icona di debug sulla barra delle azioni o usando la scorciatoia Ctrl + Shift +D. Per personalizzare le opzioni di Debug, clicca su create a launch.json file e seleziona Python File. 

Pannello di debug

Avvia il debug cliccando sul pulsante blu Run and Debug e verrà eseguito il file Python mostrandoci Variabili, Watch, Call Stack e breakpoint. 

Debug rapido

Per un debug rapido, puoi sempre cliccare sulla freccia verso il basso accanto al pulsante Run e selezionare Debug Python File.

Testing

L’estensione Python supporta i framework di test unittest e pytest. Invece di leggere i risultati dei test in un terminale, puoi rivedere e risolvere i problemi nella scheda Testing nella barra attiva.   

Configura i test Python

Dopo aver cliccato sul pulsante Testing, cliccheremo su Configure Python Tests e selezioneremo il framework di test. Di solito, VSCode rileva automaticamente il framework e mostra tutti i test in una vista ad albero. 

Scopri il unit testing in Python e come implementare il framework pytest seguendo il nostro tutorial come usare pytest per i test unitari.

Nota: l’esempio di test che stiamo usando proviene dalla documentazione ufficiale di Visual Studio Code. 

Esegui l’unittest 

Possiamo eseguire l’unit test cliccando sul pulsante Run Test nella scheda Testing e analizzando i risultati. 

Come possiamo osservare, 1 test su 2 è passato, ed è stata mostrata la motivazione del risultato fallito. Il testing in VSCode è altamente interattivo e intuitivo. 

Integrazione con Git

VSCode include l’integrazione con Git. Niente più comandi Git nel terminale. L’integrazione Git fornisce un’interfaccia grafica intuitiva e funzioni utili per diff, viste, staging, branching, commit, merge e altro. 

Dai un’occhiata al nostro Git Cheat Sheet per conoscere i vari comandi e funzionalità di Git. 

Nota: per abilitare l’integrazione con Git, devi installare Git dal sito ufficiale. 

Inizializzare Git 

Possiamo accedervi tramite la barra delle azioni o usando la scorciatoia: Ctrl + Shift + G. Prima di iniziare a fare commit, dobbiamo inizializzare il repository.

Commit Git 

Dopodiché, aggiungi e fai commit delle modifiche con un messaggio. È davvero semplice. 

Crea un repository GitHub e fai push del codice

Puoi anche creare un repository GitHub e inviare il tuo codice a un server remoto accedendo al tuo account GitHub. 

Repository GitHub privato

Abbiamo creato un repository GitHub privato di file e cartelle Python. 

Ora puoi semplicemente fare commit e push delle modifiche sul server remoto senza lasciare VSCode. 

Segui il nostro tutorial Github e Git per imparare tutto su Git e GitHub. 

Funzionalità potenziate dall’AI

Per migliorare la tua esperienza di coding in VSCode, valuta di abilitare funzionalità di completamento del codice basate sull’AI. Uno strumento di rilievo è GitHub Copilot, un pair programmer AI che suggerisce snippet di codice e intere funzioni mentre scrivi.

Per abilitare GitHub Copilot in VSCode:

1. Installa l’estensione GitHub Copilot:
   • Cerca "GitHub Copilot".
   • Clicca su Install sull’estensione GitHub Copilot.
2. Accedi a GitHub:
   • Dopo l’installazione, ti verrà chiesto di accedere al tuo account GitHub.
   • Segui le istruzioni a schermo per l’autenticazione.
3. Configura le impostazioni:
   • Accedi alle impostazioni cliccando sull’icona dell’ingranaggio in basso a sinistra e selezionando Settings.
   • Cerca "Copilot" per regolare le preferenze, ad esempio abilitare o disabilitare funzionalità specifiche.

Consigli e trucchi per uno sviluppo Python efficiente in VSCode

VSCode offre fantastiche funzionalità ed estensioni per lo sviluppo in Python. Possiamo personalizzarle in base alle nostre esigenze e aumentare la produttività. In questa sezione vedremo consigli e trucchi per uno sviluppo Python efficiente. 

1. Per iniziare: Help > Get Started. Scopri personalizzazioni e funzionalità di VSCode seguendo i tutorial guidati. 
2. Command Palette: accedi a tutti i comandi disponibili usando la scorciatoia: Ctrl+Shift+P. Scrivendo parole chiave, possiamo accedere ai comandi specifici.  
3. Scorciatoie da tastiera: meglio delle palette comandi. Possiamo modificare le scorciatoie o memorizzarle usando i fogli di riferimento. Aiuterà ad accedere direttamente ai comandi, invece di cercarli per parola chiave.
4. Riga di comando: avvia l’editor VSCode tramite interfaccia a riga di comando digitando `code .`. Possiamo anche personalizzare come si avvia l’editor aggiungendo argomenti aggiuntivi. 
5. Errori e avvisi: salta rapidamente a errori e avvisi in un progetto con la scorciatoia: Ctrl+Shift+M. Possiamo anche scorrere gli errori con F8 o Shift+F8.
6. Personalizzazione: VSCode permette di personalizzare temi, scorciatoie da tastiera, convalida JSON, impostazioni di debug, font e molto altro. È un IDE completamente personalizzabile. 
7. Estensioni: altre estensioni Python migliorano la nostra esperienza di sviluppo. Cerca le estensioni più popolari sul Visual Studio Marketplace.
8. Selezione multi-cursore: una salvezza. Aggiungi cursori in posizioni arbitrarie usando Alt+Click. Ti permetterà di modificare più righe di codice in una volta. Possiamo anche usare Ctrl+Shift+L per modificare tutte le occorrenze della selezione corrente.
9. Cerca e modifica: è lo strumento migliore per cercare e modificare più espressioni contemporaneamente. Possiamo anche rinominare il simbolo selezionandolo e premendo F2. 
10. Integrazione con Git: consente di eseguire tutte le attività legate a Git all’interno dell’IDE. Fornisce una GUI facile da usare per diff, viste, staging, branching, commit, merge e altro.
11. Snippet di codice: il nostro migliore alleato. Proprio come Autohotkey, creiamo modelli per schemi di codice ripetitivi. Per creare uno snippet personalizzato, seleziona File > Preferences > Configure User Snippets e poi scegli il linguaggio.
12. GitHub Copilot: è un’estensione vincente per ogni tipo di sviluppo. Migliora l’esperienza di coding con l’intelligenza artificiale suggerendo righe di codice o intere funzioni.

Bonus: sincronizza le tue impostazioni accedendo al tuo account GitHub. Sincronizzerà le impostazioni su tutte le tue macchine. 

Conclusione

VSCode non è solo un editor di codice. È un ecosistema completo per uno sviluppo efficiente in Python. Ci offre scorciatoie, Command Palette, IntelliSense, linting, formattazione, debugging, integrazioni con Git, notebook Jupyter, estensioni di terze parti e un’esperienza di sviluppo completamente personalizzabile. 

VSCode è altamente consigliato ai principianti che stanno imparando le basi di Python e della data science. Completa il percorso di carriera Associate Data Scientist with Python per diventare esperto in Python e data science. Il percorso comprende 25 corsi e sei progetti per prepararti a diventare un data scientist professionista.