On lance un script Python récupéré sur GitHub, et le terminal renvoie ModuleNotFoundError: No module named 'requests'. Le réflexe, c’est pip install requests, mais encore faut-il que pip soit opérationnel. Installer pip correctement sur Windows, macOS ou Linux évite des heures de débogage liées aux chemins système, aux permissions ou aux versions multiples de Python.
Vérifier si pip est déjà présent avant toute installation
Depuis Python 3.4, pip est inclus dans l’installeur officiel. Avant de télécharger quoi que ce soit, on ouvre un terminal et on tape :
A lire également : .apk corrompu ou qui ne s'installe pas : solutions simples à tester
pip --version
Si la commande renvoie un numéro de version et un chemin, pip fonctionne. Sinon, on tente pip3 --version, car sur certaines distributions Linux et sur macOS, la commande par défaut pointe vers pip3.
A lire également : Install pip installer bloqué ou introuvable : solutions rapides pour débloquer la situation
Quand aucune des deux commandes ne répond, deux scénarios se présentent : soit Python n’est pas installé, soit l’installation de Python a été faite sans cocher l’option pip. Vérifier la version de Python avec python --version permet de trancher immédiatement.
Install pip sur Windows avec l’installeur Python officiel
Sur Windows, Python n’est pas préinstallé. On récupère l’installeur depuis la page officielle python.org/downloads. Au lancement, un écran propose deux options. La case « Add python.exe to PATH » apparaît en bas, décochée par défaut.
Cocher « Add python.exe to PATH » avant de cliquer sur Install est la seule étape qui pose problème à la majorité des débutants. Sans cette case, pip s’installe bien, mais PowerShell ne le trouve pas.
Une fois l’installation terminée, on ouvre PowerShell et on vérifie :
python -m pip --version
Quand pip n’est pas reconnu malgré l’installation
Si PowerShell renvoie une erreur, le PATH n’a pas été configuré. On peut le corriger manuellement en ajoutant le répertoire Scripts de Python aux variables d’environnement système. Le chemin ressemble à C:\Users\VotreNom\AppData\Local\Programs\Python\PythonXX\Scripts.
L’autre option, plus rapide : relancer l’installeur Python, choisir « Modify », et cocher pip + la case PATH. Ça évite de manipuler le registre Windows.
WinGet comme alternative sur Windows
Microsoft propose aussi l’installation via WinGet dans PowerShell :
winget install Python.Python.3.14
Cette méthode configure automatiquement le PATH. Les retours varient sur ce point selon la version de Windows utilisée, mais sur Windows 11 récent, WinGet gère correctement les chemins.
Installer pip sur macOS sans conflit avec le Python système
macOS embarque une version de Python, mais Apple ne la met plus à jour et déconseille de l’utiliser pour le développement. On installe une version propre via le site officiel python.org ou via Homebrew.
Avec Homebrew :
brew install python
Cette commande installe Python et pip ensemble. On vérifie ensuite avec pip3 --version. Sur macOS, la commande pip3 est généralement nécessaire à la place de pip, car le système fait cohabiter plusieurs versions.
Cas où pip refuse de fonctionner sur macOS
Un problème fréquent : le terminal utilise le Python d’Apple au lieu de celui installé via Homebrew. Pour forcer le bon chemin, on ajoute cette ligne au fichier ~/.zshrc :
export PATH="/usr/local/opt/python/libexec/bin:$PATH"
Puis on recharge le profil avec source ~/.zshrc. Après cette manipulation, pip3 pointe vers la bonne installation.
Installer pip sur Linux avec le gestionnaire de paquets système
Sur les distributions Debian et Ubuntu, Python est préinstallé, mais pip ne l’est pas toujours. On l’installe via apt :
sudo apt updatepour mettre à jour la liste des paquets disponiblessudo apt install python3-pippour installer pip lié à Python 3pip3 --versionpour confirmer que l’installation a fonctionné
Sur Fedora ou CentOS, la commande équivalente est sudo dnf install python3-pip. Sur Arch Linux : sudo pacman -S python-pip.
Permissions et installation dans le Python système sur Linux
Depuis Python 3.11, les distributions Linux bloquent l’installation de paquets pip directement dans le Python système. Le message d’erreur externally-managed-environment apparaît si on tente un pip install global.
Utiliser un environnement virtuel est devenu obligatoire sur Linux moderne pour installer des packages sans toucher au système :
python3 -m venv mon_envcrée un environnement isolésource mon_env/bin/activatel’active dans le terminalpip install nom_du_packagefonctionne alors sans restriction
Cette approche protège le système d’exploitation et évite les conflits entre paquets.
Mettre à jour pip et alternatives récentes au gestionnaire de paquets
Une fois pip installé, on le met à jour avec une commande unique valable sur les trois systèmes :
python -m pip install --upgrade pip
Sur macOS et Linux, remplacer python par python3 si nécessaire. Mettre pip à jour régulièrement corrige des bugs de résolution de dépendances qui peuvent bloquer l’installation de certains packages.
uv, une alternative à pip qui gagne du terrain
L’outil uv, développé par Astral (les créateurs de Ruff, le linter Python), propose un remplacement de pip nettement plus rapide pour la résolution et l’installation de paquets. Il s’installe indépendamment de pip et gère aussi les environnements virtuels.
Pour des projets existants, pip reste le standard documenté partout. Pour de nouveaux projets où la vitesse d’installation compte (CI/CD, conteneurs Docker), uv mérite d’être testé comme gestionnaire de paquets alternatif.
L’installation de pip se résume à trois gestes : vérifier sa présence, installer ou réparer le PATH si nécessaire, puis créer un environnement virtuel pour travailler proprement. Le piège le plus courant reste le PATH mal configuré sur Windows et le conflit entre Python système et Python utilisateur sur macOS et Linux. Une fois ces deux points réglés, la gestion des packages Python ne pose plus de difficulté au quotidien.
