Pourquoi un environnement virtuel ? 01
Imagine que tu travailles sur deux projets en même temps. Le premier a besoin de la version 1.0 d'une bibliothèque, le second a besoin de la version 2.0 de la même bibliothèque. Sans environnement virtuel, tu installes tout au même endroit sur ton ordinateur — et les deux versions entrent en conflit.
Un environnement virtuel (venv) crée une bulle isolée pour chaque projet. À l'intérieur de cette bulle, tu installes les bibliothèques dont ce projet a besoin, dans les versions qu'il veut. Ça ne pollue pas le reste de ton système.
Règle d'or : un projet = un environnement virtuel. Toujours. Sans exception. Tu gagneras des heures de débogage incompréhensible.
Créer ton premier projet 02
On va créer un dossier pour notre projet, puis y créer un environnement virtuel. Ouvre ton terminal et suis ces étapes.
Étape 1 — Créer un dossier de projet
# Se déplacer dans le bureau (ou où tu veux)
cd $HOME\Desktop
# Créer un dossier
mkdir mon-premier-projet
# Entrer dans le dossier
cd mon-premier-projet# Se déplacer dans le bureau (ou où tu veux)
cd ~/Desktop
# Créer un dossier
mkdir mon-premier-projet
# Entrer dans le dossier
cd mon-premier-projetcd signifie "change directory" — ça te déplace dans un dossier. mkdir signifie "make directory" — ça crée un dossier. Ce sont deux des commandes les plus utilisées dans un terminal.
Étape 2 — Créer l'environnement virtuel
Tu es maintenant dans ton dossier mon-premier-projet. On crée le venv :
python -m venv venvpython3 -m venv venvCette commande crée un sous-dossier appelé venv dans ton projet. À l'intérieur, il y a une copie de Python et pip, isolée du reste de ton système. Tu n'as pas besoin de toucher à ce dossier directement — Python le gère pour toi.
Activer l'environnement virtuel 03
Créer le venv ne suffit pas — il faut aussi l'activer. C'est cette activation qui dit à ton terminal "pour l'instant, utilise le Python et le pip de ce venv, pas celui du système".
venv\Scripts\activateSi PowerShell refuse avec un message sur les "scripts non autorisés", tape d'abord : Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser puis réessaie.
source venv/bin/activateQuand l'environnement est actif, tu verras (venv) apparaître au début de ta ligne de commande. C'est le signal que tu es bien "dans" le venv.
(venv) C:\Users\toi\Desktop\mon-premier-projet>
# ou sur macOS/Linux :
(venv) toi@machine:~/Desktop/mon-premier-projet$Pour désactiver le venv (quand tu as fini de travailler sur le projet) :
deactivateInstaller des bibliothèques dans le venv 04
Une fois le venv activé, quand tu utilises pip install, les bibliothèques s'installent uniquement dans ce venv, pas sur tout ton système. Par exemple :
# Installer une bibliothèque (ici "requests", pour faire des appels HTTP)
pip install requests
# Voir ce qui est installé dans ce venv
pip listUne bonne pratique est de garder un fichier requirements.txt qui liste toutes les dépendances du projet. Ça permet à quelqu'un d'autre (ou toi dans 6 mois) de recréer exactement le même environnement :
# Générer le fichier (liste toutes les bibliothèques installées)
pip freeze > requirements.txt
# Recréer l'environnement à partir de ce fichier
pip install -r requirements.txtRésumé — le workflow complet 05
Voilà le workflow que tu répéteras pour chaque nouveau projet Python :
Créer un dossier pour le projet et y entrer (mkdir + cd)
Créer le venv : python -m venv venv
Activer le venv : venv\Scripts\activate (Windows) ou source venv/bin/activate (Mac/Linux)
Installer les bibliothèques dont tu as besoin avec pip install
Coder, tester, itérer
Quand tu as fini : deactivate
Ajoute venv/ à ton fichier .gitignore si tu utilises Git. On ne versionne jamais le dossier venv — il se recrée en 30 secondes depuis le requirements.txt.