Come creare e attivare un ambiente virtuale Python

Scopri come creare, attivare e gestire un ambiente virtuale Python utilizzando il modulo venv integrato. Mantieni le dipendenze del tuo progetto isolate e pulite.

Prova questa soluzione nell'editor

Panoramica

Quando sviluppi applicazioni Python, installerai spesso pacchetti di terze parti utilizzando pip. Senza un ambiente virtuale, questi pacchetti vengono installati globalmente nell'ambiente Python del tuo sistema. Ciò può portare rapidamente a conflitti se progetti diversi richiedono versioni diverse della stessa libreria (ad esempio, il progetto A necessita diDjango3.2 e il progetto B richiedeDjango5.0).

Un ambiente virtuale è una directory isolata che contiene il proprio eseguibile Python e il proprio set di pacchetti installati. Creando un ambiente virtuale per ciascuno dei tuoi progetti, ti assicuri che le installazioni dei pacchetti non interferiscano con altri progetti o con la configurazione Python a livello di sistema. Questa è una best practice fondamentale per lo sviluppo di Python.

Nel modernoPython 3, la libreria standard include il modulo `venv`, che gestisce ambienti virtuali senza richiedere strumenti esterni. Il ciclo di vita di un ambiente virtuale prevede la creazione della directory dell'ambiente, l'attivazione nella sessione terminale attiva, l'installazione delle dipendenze ed eventualmente la disattivazione al termine.

Codice e output di esecuzione

Questa simulazione mostra i comandi del terminale utilizzati per creare, attivare, installare pacchetti all'interno e disattivare un ambiente virtuale in macOS/Linux e Windows.

virtual_env.py
Prova nell'editor
commands_macos_linux = """
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate
"""

commands_windows = """
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate
"""

print("macOS & Linux terminal commands:")
print(commands_macos_linux.strip())
print("\nWindows terminal commands:")
print(commands_windows.strip())
Uscita terminale
macOS & Linux terminal commands:
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate

Windows terminal commands:
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate

Implementazione passo dopo passo

  • Esegui python -m venv <env_name> nel terminale del tuo progetto per generare i file di ambiente.
  • Attivare l'ambiente utilizzando l'origine <env_name>/bin/activate (macOS/Linux) o <env_name>\Scripts\activate (Windows).
  • Installa i pacchetti richiesti utilizzando pip install per assicurarti che siano isolati in questa directory del progetto.
  • Digita disattiva nella shell del terminale per uscire dall'ambiente virtuale una volta finito di lavorare.

Domande frequenti

Dove devo creare la cartella dell'ambiente virtuale?

Crealo direttamente nella directory principale del tuo progetto. Evita di salvare la cartella dell'ambiente virtuale (ad esempio, venv/) su Git aggiungendola al tuo file .gitignore.

Cosa fa concretamente l'attivazione di un ambiente virtuale?

L'attivazione aggiorna temporaneamente la variabile PATH della shell, indirizzandola alla cartella bin o Scripts dell'ambiente virtuale in modo che vengano eseguiti gli eseguibili python e pip locali anziché quelli a livello di sistema.

Argomenti correlati

Risorse Python consigliate

Espandi le tue conoscenze con tutorial interattivi, foglietti illustrativi e confronti di codici correlati.