Comment créer et activer un environnement virtuel Python

Découvrez comment créer, activer et gérer un environnement virtuel Python à l'aide du module venv intégré. Gardez les dépendances de votre projet isolées et propres.

Essayez cette solution dans l'éditeur

Aperçu

Lors du développement d'applications Python, vous installerez souvent des packages tiers à l'aide de pip. Sans environnement virtuel, ces packages sont installés globalement dans l'environnement Python de votre système. Cela peut rapidement conduire à des conflits si différents projets nécessitent différentes versions de la même bibliothèque (par exemple, le projet A nécessitantDjango3.2 et le projet B nécessitantDjango5.0).

Un environnement virtuel est un répertoire isolé qui contient son propre exécutable Python et son propre ensemble de packages installés. En créant un environnement virtuel pour chacun de vos projets, vous vous assurez que les installations de packages n'interfèrent pas avec d'autres projets ou avec la configuration Python à l'échelle du système. Il s’agit d’une bonne pratique fondamentale pour le développement Python.

DansPython 3moderne, la bibliothèque standard inclut le module `venv`, qui gère les environnements virtuels sans nécessiter d'outils externes. Le cycle de vie d'un environnement virtuel implique la création du répertoire d'environnement, son activation dans votre session de terminal active, l'installation des dépendances et éventuellement sa désactivation lorsque vous avez terminé.

Sortie de code et d'exécution

Cette simulation affiche les commandes de terminal utilisées pour créer, activer, installer des packages et désactiver un environnement virtuel sous macOS/Linux et Windows.

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())
Sortie 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

Mise en œuvre étape par étape

  • Exécutez python -m venv <env_name> dans le terminal de votre projet pour générer les fichiers d'environnement.
  • Activez l'environnement à l'aide de la source <env_name>/bin/activate (macOS/Linux) ou <env_name>\Scripts\activate (Windows).
  • Installez les packages requis à l'aide de pip install pour vous assurer qu'ils sont isolés dans ce répertoire de projet.
  • Tapez deactivate dans le shell du terminal pour quitter l'environnement virtuel une fois que vous avez fini de travailler.

Foire aux questions

Où dois-je créer le dossier de l’environnement virtuel ?

Créez-le directement dans le répertoire racine de votre projet. Évitez de valider le dossier de l'environnement virtuel (par exemple, venv/) dans Git en l'ajoutant à votre fichier .gitignore.

À quoi sert réellement l’activation d’un environnement virtuel ?

L'activation met temporairement à jour la variable PATH de votre shell, en la pointant vers le dossier bin ou Scripts de l'environnement virtuel afin que les exécutables python et pip locaux soient exécutés à la place de ceux à l'échelle du système.

Sujets connexes

Ressources Python recommandées

Développez vos connaissances avec des didacticiels interactifs, des aide-mémoire et des comparaisons de codes associés.