Environnement virtuel Python : le guide complet en 5 étapes

Un environnement virtuel Python isole les bibliothèques de chaque projet pour éviter les conflits de versions. Dans ce guide, tu vas apprendre à le créer, l’activer et le désactiver sur Windows, macOS et Linux, puis à partager tes dépendances avec un fichier requirements.txt. Une habitude indispensable pour travailler proprement.

Niveau : débutantDurée : ~15 minPython 3 · venv · pipWindows · macOS · Linux

Sommaire

Qu’est-ce qu’un environnement virtuel Python ?

Un environnement virtuel Python est un dossier isolé qui contient sa propre version de Python et ses propres bibliothèques. Tout ce que tu installes dedans reste limité à ton projet : ni tes autres projets, ni le Python de ton système ne sont modifiés.

🧱 IsolationChaque projet a ses propres dépendances, sans conflit de versions.

🔒 StabilitéUne mise à jour dans un projet ne casse pas les autres.

🔁 ReproductibilitéLe fichier requirements.txt recrée le même environnement ailleurs.

🤝 CollaborationToute l’équipe travaille avec exactement les mêmes versions.

Concrètement, imagine deux projets : le premier utilise Flask 2 et le second a besoin de Flask 3. Sans isolation, installer une version écrase l’autre et l’un des deux projets ne fonctionne plus. Avec un environnement par projet, chaque dossier garde sa propre version, et tu passes de l’un à l’autre simplement en activant le bon environnement.

C’est aussi une question de propreté : les bibliothèques installées pour tester une idée restent dans leur environnement. Quand le projet est terminé, il suffit de supprimer son dossier pour tout nettoyer, sans laisser de traces dans le Python de ton système.

Prérequis

Python 3 installé (sur Windows, coche « Add Python to PATH » pendant l’installation)
Un terminal : invite de commandes, PowerShell, ou le terminal intégré de Visual Studio Code
Le module venv, inclus avec Python (voir la documentation officielle de venv)

Créer un environnement virtuel Python sur Windows

1. Créer le dossier du projet

Ouvre une invite de commandes (Win + R, tape cmd, puis Entrée) et crée ton dossier de projet :

mkdir mon_projet
cd mon_projet

mkdir mon_projet
cd mon_projet

cmd

2. Créer l’environnement virtuel

Cette commande crée un dossier env qui contient l’environnement. Tu peux choisir un autre nom, mais env ou .venv sont les plus courants :

python -m venv env

python -m venv env

cmd

3. Activer l’environnement

rem Dans l'invite de commandes (cmd)
env\Scripts\activate

rem Dans PowerShell
.\env\Scripts\Activate.ps1

rem Dans l'invite de commandes (cmd)
env\Scripts\activate

rem Dans PowerShell
.\env\Scripts\Activate.ps1

cmd

Une fois activé, le nom de l’environnement apparaît entre parenthèses au début de la ligne, par exemple (env) C:\mon_projet>.

⚠️

Erreur dans PowerShell ?

Si PowerShell refuse d’exécuter le script d’activation, autorise les scripts locaux pour ton utilisateur avec Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, puis réessaie.

Depuis Visual Studio Code

Ouvre ton dossier de projet dans VS Code, puis le menu Terminal > Nouveau terminal, et tape les mêmes commandes. VS Code détecte ensuite l’environnement et te propose de l’utiliser comme interpréteur Python.

Créer un environnement virtuel Python sur Linux et macOS

Python 3 est déjà présent sur la plupart des distributions Linux. Sur Debian et Ubuntu, installe au besoin Python, pip et le module venv :

sudo apt update
sudo apt install python3 python3-pip python3-venv

sudo apt update
sudo apt install python3 python3-pip python3-venv

terminal

Crée ensuite l’environnement et active-le :

mkdir mon_projet && cd mon_projet
python3 -m venv env
source env/bin/activate

mkdir mon_projet && cd mon_projet
python3 -m venv env
source env/bin/activate

terminal

ℹ️

Sur macOS

Les commandes sont identiques à Linux. Si Python 3 n’est pas installé, télécharge-le depuis python.org ou installe-le avec Homebrew (brew install python).

Désactiver l’environnement virtuel Python

Quand tu as fini de travailler, une seule commande suffit, sur tous les systèmes :

deactivate

deactivate

terminal

Gérer les dépendances avec requirements.txt

Le fichier requirements.txt liste toutes les bibliothèques de ton projet avec leurs versions exactes. Environnement activé, génère-le avec :

pip freeze > requirements.txt

pip freeze > requirements.txt

terminal

Sur une autre machine, après avoir créé et activé un nouvel environnement virtuel Python, réinstalle exactement les mêmes dépendances :

pip install -r requirements.txt

pip install -r requirements.txt

terminal

💡

Avec Git

N’ajoute jamais le dossier env à ton dépôt : il est lourd et propre à ta machine. Ajoute la ligne env/ dans ton fichier .gitignore et partage uniquement requirements.txt.

Les erreurs fréquentes et leurs solutions

« python » n’est pas reconnuPython n’est pas dans le PATH. Réinstalle-le en cochant « Add Python to PATH », ou utilise la commande py sous Windows.

« No module named venv »Sur Debian et Ubuntu, le module est séparé : installe-le avec sudo apt install python3-venv.

pip installe au mauvais endroitL’environnement n’est pas activé. Vérifie que son nom apparaît entre parenthèses avant de lancer pip install.

VS Code n’utilise pas le bon PythonOuvre la palette de commandes (Ctrl + Maj + P), choisis « Python: Select Interpreter » et sélectionne celui du dossier env.

Bon à savoir : pense à mettre à jour pip dans chaque nouvel environnement avec python -m pip install --upgrade pip. Tu éviteras ainsi de nombreux avertissements lors de l’installation des bibliothèques.

Récapitulatif des commandes

Créerpython -m venv env
(python3 sur Linux et macOS)

ActiverWindows : env\Scripts\activate
Linux / macOS : source env/bin/activate

Désactiverdeactivate

Dépendancespip freeze > requirements.txt
pip install -r requirements.txt

Mettre en pratique

Le meilleur moyen de prendre l’habitude, c’est de créer un environnement virtuel Python pour chacun de tes projets. Quelques idées pour t’entraîner :

Calculateur de nombres premiers en Python, qui utilise le module colorama
Outil de gestion de projets avec Python et Flask
ChatGPT local avec Ollama, un projet avec de nombreuses dépendances

FAQ : questions fréquentes

Faut-il créer un environnement virtuel pour chaque projet ?

Oui, c’est la bonne pratique. Chaque projet garde ainsi ses propres versions de bibliothèques, sans risque de conflit avec les autres.

Quelle différence entre venv et virtualenv ?

venv est inclus dans Python 3 et suffit dans la grande majorité des cas. virtualenv est un outil externe plus ancien, avec quelques options supplémentaires.

Comment savoir si mon environnement est activé ?

Son nom apparaît entre parenthèses au début de la ligne du terminal, par exemple (env). La commande pip list n’affiche alors que les bibliothèques installées dans l’environnement.

Puis-je supprimer un environnement virtuel ?

Oui : désactive-le avec deactivate, puis supprime simplement le dossier env. Tu pourras le recréer à tout moment grâce à requirements.txt.

Tu sais maintenant créer, activer et partager un environnement virtuel Python. Prends l’habitude d’en utiliser un pour chaque projet : ton futur toi te remerciera ! Une question ? Laisse un commentaire.