Backend
Python — environnements virtuels et pip
Créer un venv, choisir le bon interpréteur, installer les dépendances et diagnostiquer les erreurs Python sur Windows, macOS et Linux.
24commandesMis à jour le7 septembre 2026NiveauIntermédiaire
Aucune commande ne correspond à ce choix et à votre recherche.
Quelle erreur rencontrez-vous ?
| Message ou symptôme | Correction à vérifier |
|---|---|
externally-managed-environment |
Créer un venv ; pour un outil CLI autonome, envisager pipx |
ModuleNotFoundError après installation |
Comparer le Python de l’IDE avec celui de python -m pip ; le nom importé peut différer du nom du paquet |
venv ou ensurepip absent |
Installer le composant venv correspondant au Python de votre distribution |
No matching distribution found |
Vérifier le nom du paquet, l’index, la version Python et l’architecture |
| Échec de compilation | Consulter les prérequis natifs du paquet ou choisir une version Python prise en charge |
ResolutionImpossible |
Aligner les contraintes de versions des dépendances |
| Activation PowerShell bloquée | Utiliser directement le python.exe du venv, sans changer la politique de scripts |
Les commandes python supposent un venv activé. Choisissez la version Python du projet et son interpréteur dans l’IDE. Le filtre Windows utilise PowerShell ; macOS/Linux utilisent Bash ou Zsh. Dans WSL, choisissez Linux.
| Fichier du projet | Installation |
|---|---|
requirements.txt |
pip avec le fichier existant |
pyproject.toml |
Suivre le mode d’installation prévu par le projet |
uv.lock, poetry.lock ou autre lockfile |
Utiliser le gestionnaire associé et sa commande de synchronisation |
Ignorez .venv/ dans Git. Recréez l’environnement après un changement de machine ou de version Python ; pip freeze est un instantané, pas un lockfile portable. Un venv isole les dépendances, mais n’empêche pas un paquet d’exécuter du code sur la machine.
Terminez par python -m pip check et les tests du projet. Évitez sudo pip install et --break-system-packages pour une installation courante.
Créer l’environnement
6 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
python3 --versionmacOS · Linux | Vérifier Python 3 installé. Choisir la version attendue par le projet. | python3 --version | Sûr |
py --versionWindows | Vérifier le lanceur Python Windows ; si absent, utiliser le python installé et vérifier sa version. | py --version | Sûr |
python3 -m venv .venvmacOS · Linux | Créer un environnement dans un dossier .venv neuf à la racine du projet. | python3 -m venv .venv | Sûr |
py -m venv .venvWindows | Créer un environnement avec le Python sélectionné par le lanceur Windows. | py -m venv .venv | Sûr |
source .venv/bin/activatemacOS · Linux | Activer dans le terminal Bash/Zsh courant. Fish et les autres shells ont un script différent. | source .venv/bin/activate | Sûr |
.\.venv\Scripts\Activate.ps1Windows | Activer dans PowerShell. Si la politique de scripts le bloque, utiliser directement le Python du venv. | .\.venv\Scripts\Activate.ps1 | Sûr |
Confirmer le bon Python
4 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
python -cWindows · macOS · Linux | Afficher l’exécutable et vérifier l’isolement après activation. True signifie que les préfixes diffèrent. | python -c "import sys; print(sys.executable); print(sys.prefix != sys.base_prefix)" | Sûr |
python -m pip --versionWindows · macOS · Linux | Afficher pip et son chemin : ils doivent correspondre à .venv. | python -m pip --version | Sûr |
.venv/bin/python -m pip --versionmacOS · Linux | Utiliser pip sans activer le venv ; utile dans un script ou un terminal où l’activation est impossible. | .venv/bin/python -m pip --version | Sûr |
.\.venv\Scripts\python.exe -m pip --versionWindows | Utiliser le Python du venv sans changer la politique d’exécution PowerShell. | .\.venv\Scripts\python.exe -m pip --version | Sûr |
Installer et maintenir
5 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
python -m pip install -rWindows · macOS · Linux | Installer les dépendances d’un requirements.txt existant et de confiance. Respecter le gestionnaire prévu par le projet. | python -m pip install -r requirements.txt | Attention |
python -m pip installWindows · macOS · Linux | Installer un paquet dans le venv actif ; exemple avec requests. Reporter la dépendance dans le manifeste du projet. | python -m pip install requests | Attention |
python -m pip install --upgradeWindows · macOS · Linux | Mettre à jour un paquet choisi après avoir vérifié ses changements. Peut actualiser ses dépendances. | python -m pip install --upgrade requests | Attention |
python -m pip install -e .Windows · macOS · Linux | Installer le projet local en mode éditable s’il possède une configuration de packaging. Le build peut exécuter du code. | python -m pip install -e . | Attention |
python -m pip uninstallWindows · macOS · Linux | Désinstaller un paquet du venv ; demande confirmation et ne retire pas automatiquement ses dépendances. | python -m pip uninstall requests | Attention |
Diagnostiquer l’installation
6 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
python -m pip listWindows · macOS · Linux | Lister les paquets installés dans cet environnement. | python -m pip list | Sûr |
python -m pip showWindows · macOS · Linux | Afficher la version et le dossier d’installation d’un paquet. | python -m pip show requests | Sûr |
python -m pip checkWindows · macOS · Linux | Détecter les dépendances absentes ou incompatibles parmi les paquets installés. | python -m pip check | Sûr |
python -m pip list --outdatedWindows · macOS · Linux | Consulter les versions plus récentes sans les installer ; nécessite l’accès à l’index configuré. | python -m pip list --outdated | Sûr |
python -m pip freezeWindows · macOS · Linux | Afficher un instantané des versions installées. Ce n’est pas un lockfile universel entre systèmes. | python -m pip freeze | Sûr |
python -m pip debug --verboseWindows · macOS · Linux | Voir les tags de compatibilité du Python et des wheels. Utile pour un paquet sans distribution compatible. | python -m pip debug --verbose | Sûr |
Exécuter et quitter
3 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
python -m pytestWindows · macOS · Linux | Exécuter les tests si pytest est une dépendance de test déjà installée dans le projet. | python -m pytest | Sûr |
python script.pyWindows · macOS · Linux | Lancer un fichier existant avec le Python du venv. Adapter le nom au projet. | python script.py | Sûr |
deactivateWindows · macOS · Linux | Quitter l’environnement activé dans ce terminal ; ne supprime ni .venv ni ses paquets. | deactivate | Sûr |