Environnements virtuels Python avec venv : définition et utilisation
Ce qu’est un environnement virtuel Python, pourquoi l’utiliser dans chaque projet et comment le créer, l’activer et le gérer avec venv sous Windows et Linux.
Dès que l’on commence à utiliser Python sérieusement, on rencontre un problème : chaque projet a besoin de ses propres bibliothèques, parfois dans des versions différentes. Un script veut une certaine version d’une bibliothèque, un autre projet en veut une plus récente, et tout installer au même endroit finit tôt ou tard par provoquer des conflits difficiles à comprendre.
La solution s’appelle l’environnement virtuel. Dans ce guide, nous voyons ce que c’est, pourquoi il vaut mieux toujours l’utiliser et comment le gérer avec venv, l’outil inclus dans Python, sous Windows comme sous Linux.
Qu’est-ce qu’un environnement virtuel
Un environnement virtuel est un dossier qui contient une copie isolée de Python avec ses propres bibliothèques. Lorsque l’environnement est actif, tout ce que vous installez y est placé, et non dans le Python général de l’ordinateur.
On peut l’imaginer comme une boîte à outils dédiée à un seul travail : chaque projet a la sienne, avec les outils dont il a besoin, et les boîtes ne se mélangent pas.
Les avantages concrets sont au nombre de trois :
- Pas de conflits : deux projets peuvent utiliser des versions différentes de la même bibliothèque.
- Le système reste propre : sous Linux en particulier, vous ne risquez pas d’endommager le Python utilisé par le système d’exploitation.
- Le projet est reproductible : vous pouvez recréer le même environnement sur un autre ordinateur ou sur un serveur avec une seule commande.
Avant de commencer
Il vous faut Python déjà installé. Sous Ubuntu et Debian, assurez-vous aussi d’avoir le module venv, qui n’est pas toujours présent :
sudo apt install python3-venv
Sous Windows, si vous avez installé Python avec le Python Install Manager, venv est déjà inclus.
Créer un environnement virtuel
Ouvrez le terminal dans le dossier de votre projet et tapez :
# Windows
python -m venv .venv
# Linux et macOS
python3 -m venv .venv
La commande crée un dossier nommé .venv contenant tout le nécessaire. Ce nom est une convention très répandue : le point initial le rend « caché » sous Linux et la plupart des éditeurs le reconnaissent automatiquement. Vous pouvez l’appeler comme vous voulez, mais .venv est le choix le plus pratique.
Sous Windows, si plusieurs versions de Python sont installées, vous pouvez choisir celle avec laquelle créer l’environnement :
py -V:3.14 -m venv .venv
L’environnement utilisera toujours la version avec laquelle il a été créé.
Activer l’environnement
Créer l’environnement ne suffit pas : il faut l’activer chaque fois que vous ouvrez un nouveau terminal pour travailler sur le projet. La commande dépend du système :
# Windows, invite de commandes
.venv\Scripts\activate
# Windows, PowerShell
.venv\Scripts\Activate.ps1
# Linux et macOS
source .venv/bin/activate
Quand l’environnement est actif, son nom apparaît entre parenthèses au début de la ligne du terminal, par exemple (.venv). C’est le signe que vous travaillez dans l’environnement.
Si PowerShell bloque le script d’activation avec une erreur de stratégie d’exécution, autorisez l’exécution des scripts locaux pour votre utilisateur avec cette commande, à lancer une seule fois :
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
Installer des bibliothèques
Avec l’environnement actif, les bibliothèques s’installent avec pip, le gestionnaire de paquets de Python :
python -m pip install requests
Pourquoi python -m pip et pas simplement pip ? Parce qu’ainsi vous êtes sûr que pip installe la bibliothèque dans le Python que vous utilisez. Avec la commande pip seule, si l’environnement n’est pas actif ou si plusieurs versions sont installées, la bibliothèque pourrait se retrouver au mauvais endroit. C’est une petite habitude qui évite bien des problèmes.
Pour voir les bibliothèques installées dans l’environnement :
python -m pip list
Enregistrer et recréer les dépendances avec requirements.txt
Les bibliothèques utilisées par un projet s’appellent des dépendances. Pour enregistrer leur liste, avec les versions exactes, on utilise un fichier nommé requirements.txt :
python -m pip freeze > requirements.txt
Sur un autre ordinateur, ou sur le serveur, il suffit de créer un nouvel environnement virtuel, de l’activer et de tout installer en une seule commande :
python -m pip install -r requirements.txt
Le fichier requirements.txt doit être conservé avec le code du projet. Le dossier .venv, en revanche, ne doit être ni copié ni ajouté à Git : il contient des chemins liés à votre ordinateur et se recrée en quelques secondes. Si vous utilisez Git, ajoutez cette ligne au fichier .gitignore :
.venv/
Désactiver et supprimer un environnement
Pour sortir de l’environnement virtuel, il suffit de taper :
deactivate
Pour le supprimer complètement, effacez simplement le dossier .venv. Il n’y a rien à désinstaller : tout ce qu’il contenait se trouvait dans ce dossier.
C’est aussi utile lorsque vous voulez changer de version de Python pour un projet : supprimez le dossier, recréez l’environnement avec la nouvelle version et réinstallez les dépendances depuis requirements.txt.
Utiliser l’environnement avec Visual Studio Code
Si vous utilisez Visual Studio Code avec l’extension Python, l’éditeur reconnaît généralement tout seul le dossier .venv. Sinon, ouvrez la palette de commandes avec Ctrl+Shift+P, cherchez Python: Select Interpreter et choisissez l’interpréteur situé dans .venv. À partir de là, le terminal intégré activera lui aussi l’environnement automatiquement.
Erreurs courantes et solutions
- « ModuleNotFoundError: No module named … » : presque toujours, l’environnement n’est pas actif ou la bibliothèque a été installée dans un autre Python. Activez l’environnement et réinstallez la bibliothèque avec
python -m pip install. - « error: externally-managed-environment » sous Linux : vous essayez d’installer une bibliothèque dans le Python du système. Créez et activez un environnement virtuel et refaites l’installation à l’intérieur.
- « The virtual environment was not created successfully because ensurepip is not available » sous Ubuntu ou Debian : le paquet
python3-venvmanque. Installez-le avecsudo apt install python3-venv, supprimez le dossier.venvincomplet et recréez l’environnement. - L’environnement ne fonctionne plus après avoir déplacé ou renommé le dossier du projet : les environnements virtuels contiennent des chemins absolus et ne supportent pas les déplacements. Supprimez-le et recréez-le.
- Erreur « Microsoft Visual C++ 14.0 or greater is required » lors de l’installation d’une bibliothèque : en général, l’environnement a été créé avec une version de Python trop récente pour cette bibliothèque. Nous avons consacré un article à cette erreur.
Un coup d’œil aux outils alternatifs
Outre venv, il existe des outils plus complets, comme uv ou Poetry, qui gèrent d’un seul coup environnements, dépendances et versions de Python. Ils sont très appréciés dans les projets plus importants. Pour débuter, venv reste toutefois le meilleur choix : il est déjà inclus dans Python, fonctionne partout, et les notions apprises ici valent aussi pour les autres outils.
Récapitulatif
Le flux de travail de tout projet Python se résume à quelques commandes :
- Une seule fois :
python -m venv .venvdans le dossier du projet. - Chaque fois que vous travaillez sur le projet : activez l’environnement.
- Pour ajouter des bibliothèques :
python -m pip install nom, puis mettez à jourrequirements.txt. - Sur un autre ordinateur : créez l’environnement, activez-le et lancez
python -m pip install -r requirements.txt.
Sources officielles
Partager
Quelle est votre réaction ?
Aimer
0
Je n'aime pas
0
Amour
0
Drôle
0
En colère
0
Triste
0
Waouh
0