1. Vérifier que Python 3 est installé
Ubuntu inclut généralement Python 3 par défaut. Pour vérifier, ouvrez un terminal et tapez :
bashCopierModifierpython3 --version
Vous devriez voir quelque chose comme :
nginxCopierModifierPython 3.x.x
Si Python 3 n’est pas installé (très rare), installez-le :
bashCopierModifiersudo apt update
sudo apt install python3
2. Installer le paquet python3-venv
Pour pouvoir créer des environnements virtuels avec le module intégré venv, assurez-vous que le paquet python3-venv est installé :
sudo apt update
sudo apt install python3-venv
Ce paquet fournit le module nécessaire (venv) pour créer des environnements isolés.
3. Créer un nouvel environnement virtuel
- Choisissez (ou créez) un dossier pour votre projet
Par exemple, supposons que votre projet se trouve dans le dossiermonprojet: bashCopierModifiermkdir ~/monprojet cd ~/monprojet - Créez l’environnement virtuel
À l’intérieur du dossier de votre projet, exécutez : bashCopierModifierpython3 -m venv venvpython3 -m venvinvoque le module standardvenv.- Le second argument, ici
venv, est le nom du dossier (relatif) qui sera créé pour contenir l’environnement virtuel. Vous pouvez choisir un autre nom (par exempleenvou.venv), maisvenvest courant.
Après exécution, le dossier venv/ contiendra une structure du type :
venv/
├── bin/
│ ├── activate
│ ├── python ← lien vers l’interpréteur isolé
│ └── pip ← gestionnaire de paquets isolé
├── lib/
│ └── python3.x/
│ └── site-packages/ ← où seront installés vos paquets
└── pyvenv.cfg
4. Activer l’environnement virtuel
Pour que vos commandes python et pip pointent vers cet environnement isolé, vous devez l’« activer ». Dans le terminal, toujours dans le dossier ~/monprojet, tapez :
source venv/bin/activate
Une fois activé, vous devriez voir le nom de l’environnement (ici venv) en début de ligne de votre invite, par exemple :
(venv) user@machine:~/monprojet$
Cela signifie que :
pythonpointe désormais versvenv/bin/pythonpippointe versvenv/bin/pip- Toute installation
pip install ...restera confinée dansvenv/, sans impacter l’installation globale de votre système.
5. Installer des paquets dans l’environnement
Une fois activé, utilisez simplement pip pour installer ce dont vous avez besoin :
pip install requests flask numpy
Les paquets seront installés dans venv/lib/python3.x/site-packages/. Vous pouvez lister les paquets avec :
pip list
Pour figer (verrouiller) vos dépendances dans un fichier requirements.txt :
pip freeze > requirements.txt
Plus tard, si vous (ou quelqu’un d’autre) souhaitez recréer l’environnement à l’identique :
pip install -r requirements.txt
6. Désactiver l’environnement virtuel
Lorsque vous avez fini de travailler dans cet environnement et que vous voulez revenir à votre Python système, tapez simplement :
deactivate
Votre invite ne montrera plus (venv) en début de ligne, et python/pip redeviendront ceux du système global.
7. Supprimer ou recréer l’environnement
- Pour supprimer l’environnement : fermez l’environnement (
deactivate) puis supprimez le dossier : bashCopierModifierrm -rf venv - Pour le recréer (à partir de zéro), refaites
python3 -m venv venvpuis réactivez et réinstallez vos dépendances.
8. Alternative avec virtualenv
Si vous préférez, vous pouvez installer l’outil tiers virtualenv, qui fonctionne très bien pour Python 3 :
- Installez-le globalement (en dehors de tout environnement) : bashCopierModifier
sudo apt update sudo apt install python3-pip pip3 install virtualenv - Créez un environnement isolé : bashCopierModifier
cd ~/monprojet virtualenv -p python3 env_virtuel- Ici, on crée un dossier
env_virtuel/.
- Ici, on crée un dossier
- Activez-le : bashCopierModifier
source env_virtuel/bin/activate - Désactivez-le avec
deactivate, et supprimez-le avecrm -rf env_virtuelsi nécessaire.
L’avantage de virtualenv est qu’il peut être utilisé par un utilisateur même si python3-venv n’est pas installé, et il fournit parfois un démarrage plus rapide. Mais pour la plupart des usages sur Ubuntu, le module intégré venv suffit.
9. Bonnes pratiques
- Nom d’environnement : choisissez un nom clair (par exemple
.venvouvenv) et ajoutez-le à votre fichier.gitignoresi vous versionnez votre projet. - Isolation : ne mélangez pas vos projets. Utilisez un environnement par projet.
- Répertoire du projet : conservez les sources du projet à côté du dossier
venv/, pas à l’intérieur, pour éviter de versionner l’environnement virtuel. - Fichier
requirements.txt: générez-le (ou unPipfile.lock) pour garantir que toute l’équipe utilise exactement les mêmes versions de paquets. - Scripts d’activation : pour plus de confort, vous pouvez ajouter un alias dans votre
~/.bashrc: bashCopierModifieralias actmonscript="source ~/monprojet/venv/bin/activate"puis faireactmonscriptpour activer en un clin d’œil.
Exemple complet de session
# 1. Aller dans le dossier du projet
cd ~/monprojet
# 2. Créer l'environnement virtuel
python3 -m venv venv
# 3. Activer l'environnement
source venv/bin/activate
# Votre invite devient (venv) user@machine:~/monprojet$
# 4. Installer des paquets
pip install Django psycopg2-binary
# 5. Sauvegarder les dépendances
pip freeze > requirements.txt
# 6. Travailler sur votre application...
python manage.py runserver
# 7. Quand vous avez terminé :
deactivate
# (venv) disparaît et vous retournez au Python système
# 8. Supprimer l'environnement si besoin :
rm -rf venv
Voilà ! En suivant ces étapes, vous aurez un environnement Python isolé sur Ubuntu pour gérer proprement vos paquets projet par projet.






