L’erreur « pip is not recognized as an internal or external command » sur Windows ne signale presque jamais une absence réelle de pip. Depuis Python 3.4, pip est livré avec l’interpréteur. Le problème vient de la cohabitation de plusieurs distributions Python ou d’une variable PATH mal configurée, deux situations que l’installeur du Microsoft Store aggrave par rapport à celui de python.org.
Conflit entre distributions Python sur Windows : identifier l’interpréteur actif
Avant de toucher à pip, nous recommandons de vérifier quel exécutable Python répond réellement dans le terminal. La commande where python (dans cmd) ou Get-Command python (dans PowerShell) liste tous les binaires trouvés dans le PATH, par ordre de priorité.
A lire aussi : Comment acheter ses cartouches d’encre au meilleur prix
Sur un poste où cohabitent une installation python.org, Anaconda et la version Microsoft Store, cette liste renvoie souvent trois chemins distincts. Le premier de la liste est celui que Windows exécute par défaut, et son pip associé peut pointer vers un environnement complètement différent de celui que vous pensez utiliser.
Python du Microsoft Store et ses limitations
L’installation via le Microsoft Store ne configure ni le PATH système ni pip de la même façon que l’installeur officiel. Résultat : python fonctionne, mais pip renvoie une erreur. L’exécutable du Store crée un alias dans %LOCALAPPDATA%\Microsoft\WindowsApps qui ne contient pas pip dans son arborescence.
A lire aussi : Connexion Bluetooth : mode d'emploi pour votre PC
Pour contourner ce problème sans désinstaller la version Store, utilisez systématiquement la syntaxe python -m pip au lieu d’appeler pip directement. Cette forme force l’appel via l’interpréteur actif et élimine l’ambiguïté du PATH.
Réinstaller pip avec ensurepip : la méthode qui remplace get-pip.py
Depuis Python 3.12, la documentation officielle relègue get-pip.py au rang de script de bootstrapping legacy. La méthode recommandée est désormais le module intégré ensurepip.
Ouvrez un terminal avec les droits administrateur et exécutez :
python -m ensurepip --upgrade
Ce module réinstalle pip à partir des fichiers déjà embarqués dans la distribution Python, sans téléchargement externe. Deux avantages : aucune dépendance réseau au moment de la réparation, et aucune incompatibilité de version puisque le pip fourni correspond exactement à la version de l’interpréteur.
Quand ensurepip échoue
Si ensurepip renvoie une erreur du type « No module named ensurepip », l’installation Python elle-même est corrompue ou incomplète. Cela arrive fréquemment quand l’installeur python.org a été lancé sans cocher la case « Add Python to PATH » et sans l’option « pip ». Dans ce cas, relancez l’installeur, sélectionnez « Modify », et activez explicitement pip et la case PATH.
Erreur « Could not find a version that satisfies the requirement » : causes réseau et nommage
Cette erreur ne signifie pas toujours que le package n’existe pas sur PyPI. Nous observons trois causes principales sur les postes Windows en entreprise.
- Un proxy ou un pare-feu bloque l’accès HTTPS à pypi.org. Vérifiez avec
python -m pip install requests --proxy http://votre-proxy:portou configurez la variable d’environnementHTTPS_PROXY. - Le nom du package est mal orthographié. PyPI distingue tirets et underscores :
scikit-learnn’est passcikit_learn. La page pypi.org du package fait référence. - La version de Python installée n’est pas compatible avec le package demandé. Certaines bibliothèques abandonnent le support de versions anciennes. Ajoutez
--verboseà la commande pip pour lire quelle contrainte de version bloque.
Variable PATH Windows : corriger le problème à la source
Modifier le PATH manuellement reste la correction la plus fiable quand l’installeur n’a pas fait son travail. Ouvrez les paramètres système (recherchez « variables d’environnement » dans le menu Démarrer), puis éditez la variable Path de l’utilisateur.
Deux chemins doivent y figurer pour une installation Python standard :
- Le dossier contenant
python.exe(par exempleC:\Users\votre-nom\AppData\Local\Programs\Python\Python312) - Le sous-dossier
Scriptsdu même répertoire, qui contientpip.exe - Si vous utilisez des environnements virtuels, le dossier
Scriptsdu venv actif prend la priorité automatiquement, ce qui est le comportement attendu
Après modification, fermez et rouvrez le terminal. Les modifications du PATH ne s’appliquent pas aux sessions déjà ouvertes.
Utiliser pipx pour les outils en ligne de commande
pipx isole chaque outil Python dans son propre environnement virtuel, ce qui supprime les conflits de dépendances entre packages globaux. Pour les utilitaires comme black, flake8 ou poetry, pipx est désormais la méthode recommandée sur Windows. Installez-le via python -m pip install --user pipx, puis lancez pipx ensurepath pour configurer le PATH automatiquement.
Erreurs de permissions et d’écriture sur Windows
Les messages « Permission denied » ou « Access is denied » apparaissent quand pip tente d’écrire dans un répertoire système protégé. Sur Windows, n’utilisez jamais pip avec des droits administrateur pour installer des packages utilisateur. Préférez le flag --user qui installe dans le répertoire personnel :
python -m pip install --user nom-du-package
Cette approche évite aussi de polluer l’installation Python globale. En environnement professionnel, nous recommandons de travailler systématiquement dans un environnement virtuel (créé via python -m venv mon-env), qui contourne entièrement la question des permissions et des conflits entre projets.
La majorité des erreurs pip sur Windows se résolvent en vérifiant trois points : quel interpréteur Python répond réellement, si le PATH inclut le dossier Scripts, et si un proxy réseau bloque PyPI. Quand ces trois éléments sont confirmés, la commande python -m pip install fonctionne sans accroc, quelle que soit la bibliothèque visée.
