Come verificare la versione di Python: Windows, macOS e Linux

Sapere quale versione di Python stai usando è più importante di quanto sembri. Molte librerie e framework dipendono da versioni specifiche di Python e il codice può comportarsi in modo diverso tra un rilascio e l’altro. Eseguire script su una versione non supportata o inaspettata porta spesso a errori di installazione o di runtime difficili da diagnosticare.

In questa guida, ti mostrerò modi semplici e affidabili per controllare la versione di Python nei sistemi operativi, ambienti e setup più comuni. Se stai iniziando con Python, ti consiglio il nostro corso Introduzione a Python, che copre competenze come tipi di dato, liste, funzioni di base e pacchetti.

Come controllare la versione di Python dalla riga di comando

Il modo più comune per verificare la versione di Python è usare il terminale del computer (Mac/Linux) o il Command Prompt/PowerShell (Windows).

Usare python --version

Questo comando chiede al sistema quale interprete Python è associato al comando python e ne stampa la versione.

python --versionOfferto da

Questo comando funziona sulla maggior parte dei sistemi se python è configurato correttamente nel PATH. Tuttavia, potrebbe fallire se python punta a Python 2 o non esiste nel PATH.

Usare python3 --version

Alcuni sistemi, in particolare macOS e Linux, richiedono di usare python3 per fare riferimento esplicito a Python 3. Questo perché molti computer moderni hanno sia Python 2 che Python 3 installati.

python3 --versionOfferto da

Su Windows, questo comando potrebbe non funzionare a meno che Python non sia stato installato aggiungendo esplicitamente python3.

Usare python -V (Sintassi alternativa)

Questo comando è una forma abbreviata di python --version.

python -VOfferto da

Il comando produce lo stesso output ma si comporta in modo leggermente diverso in alcuni ambienti. In alcuni ambienti più vecchi o in shell specifiche, il numero di versione potrebbe essere inviato a stderr (standard error) invece che a stdout (standard output).

A occhio nudo, sullo schermo sembra lo stesso, ma negli script può fare la differenza se stai cercando di “pippare” quel testo in un altro file o programma.

Come controllare la versione di Python dall’interno di Python

A volte potresti voler controllare la versione di Python da uno script o da una sessione interattiva. È utile quando vuoi che il tuo codice confermi l’ambiente di runtime per aiutare a fare debug dei problemi nello script.

Puoi accedere ai dettagli della versione importando la libreria integrata sys. Il codice seguente mostra la stringa completa della versione di Python insieme ai dettagli di build.

-- Check Python version
import sys
print(sys.version)Offerto da

Questo metodo è utile quando scrivi logiche condizionali che dipendono dalla versione di Python e per registrare informazioni sul runtime.

Verificare la versione di Python negli ambienti virtuali

Poiché gli ambienti virtuali (venv e conda) sono usati per progetti specifici, possono utilizzare una versione di Python diversa da quella predefinita del sistema. Se crei un ambiente virtuale, include un interprete Python specifico e attivando l’ambiente cambi quale eseguibile Python viene utilizzato.

Per confermare la versione attiva di Python nel tuo ambiente virtuale, prima attivalo, poi esegui il seguente comando:

python --versionOfferto da

Se la versione visualizzata non è quella che ti aspetti, l’ambiente potrebbe essere stato creato con un’installazione diversa di Python o potrebbe non essere attualmente attivato.

Ti consiglio di usare la nostra Conda Cheat Sheet quando vuoi avere sott’occhio la gestione dei pacchetti e il lavoro con l’ambiente conda.

Come controllare la versione di Python su diversi sistemi operativi

Ogni sistema operativo gestisce Python in modo leggermente diverso. Ecco come controllare la versione di Python in ognuno:

Windows

Per controllare la versione di Python in Windows, puoi usare:

python --versionOfferto da

Oppure:

py --versionOfferto da

Gli svantaggi di questo metodo sono che più installazioni di Python possono creare confusione, oppure python potrebbe non essere riconosciuto a causa di una configurazione errata del PATH. Inoltre, il launcher py può puntare a una versione diversa rispetto a python, causando errori.

macOS e Linux

Su macOS e Linux, tieni presente che il sistema può includere un Python preinstallato usato internamente dall’OS. Inoltre, python può riferirsi a Python 2 o non esistere affatto, mentre python3 di solito punta alla versione di Python 3 installata dall’utente.

Puoi controllare la versione di Python su macOS o Linux usando:

python --versionOfferto da

Oppure usa python3 per evitare di utilizzare per errore un Python obsoleto o gestito dal sistema.

python3 --versionOfferto da

Problemi comuni quando si controlla la versione di Python

Quando controlli la versione di Python, potresti avere un po’ di confusione, soprattutto quando sono coinvolti più strumenti e ambienti:

• “Python command not found”: di solito significa che Python non è installato o non è stato aggiunto al PATH del sistema. Su alcuni sistemi è disponibile solo python3, non python.

• Più versioni di Python installate: è comune avere più di una versione di Python sulla stessa macchina. Comandi diversi come python, python3 e py possono puntare a interpreti diversi, il che può rendere incoerenti i controlli della versione.

• Il comando restituisce una versione inattesa: potresti stare controllando un’installazione di Python diversa da quella prevista. Succede spesso quando un ambiente virtuale non è attivato o quando l’ordine del PATH dà priorità a un altro eseguibile Python.

• Versione IDE diversa da quella del terminale: il tuo IDE, come VS Code o PyCharm, può essere configurato per usare un interprete Python diverso da quello del terminale. Il codice eseguito nell’IDE usa il suo interprete configurato e potrebbe non essere quello restituito da python --version nella riga di comando.

Buone pratiche per gestire le versioni di Python

Per evitare sorprese legate alle versioni, ti consiglio di seguire la checklist qui sotto:

• Controlla sempre la versione di Python prima di installare le dipendenze: esegui sempre python --version prima di un comando come pip install. In questo modo eviti di installare librerie nella versione sbagliata.

• Sii esplicito con i comandi: se sai che ti serve Python 3, usa python3 invece di presumere che python punti alla versione corretta.

• Usa con coerenza gli ambienti virtuali: utilizza un ambiente virtuale (venv) per ogni nuovo progetto. Mantiene versione e librerie del progetto isolate dal resto del sistema, assicurando che ciascuno usi la versione di Python e le dipendenze corrette.

• Evita di fare affidamento sul Python di sistema per i progetti: il Python gestito dal sistema è spesso usato dall’OS e dovrebbe essere lasciato intatto. Installa sempre una tua versione di Python per i progetti per ottenere i risultati previsti.

Conclusione

Essere espliciti su quale versione di Python stai eseguendo ti aiuta a evitare problemi comuni di setup, riduce la confusione e fa risparmiare tempo quando installi pacchetti o risolvi errori.

Per una comprensione approfondita di Python, puoi imparare di più dai nostri percorsi di competenze Fondamenti di dati in Python e Fondamenti di programmazione in Python. Infine, personalmente raccomando il nostro percorso professionale Sviluppatore Python per imparare il testing del codice e il controllo versione nello scraping web e nello sviluppo di pacchetti.