Les développeurs Python débutants sont souvent confrontés à des erreurs lors de l'importation de modules, comme l'indique ce message :
Traceback (most recent call last):
File "script.py", line 3, in <module>
import mon_module
ModuleNotFoundError: No module named 'mon_module'
Cette erreur survient car certains modules ne sont pas inclus par défaut dans l'installation de Python et nécessitent une installation manuelle. Ce guide explique comment installer des paquets tiers, accélérer les téléchargements avec des miroirs, et résoudre les problèmes courants liés à pip.
Installation de modules via pip
Pour installer un module, ouvrez l'invite de commandes en appuyatn sur Windows + R, tapez cmd, puis exécutez la commande suivante, en remplaçant mon_paquet par le nom du module requis :
pip install mon_paquet
Le téléchargement depuis le dépôt officiel peut être lent. Utilisez des miroirs nationaux pour accélérer le processus.
Accélération avec des sources miroir
Des miroirs en Chine permettent des téléchargements plus rapides. Pour une utilisation temporaire :
pip install mon_paquet -i https://pypi.tuna.tsinghua.edu.cn/simple
Pour une configuration permanente, qui s'appliquera à toutes les installations futures :
pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/
Voici quelques miroirs courants :
- Tsinghua :
https://pypi.tuna.tsinghua.edu.cn/simple - Alibaba Cloud :
http://mirrors.aliyun.com/pypi/simple/ - USTC :
https://pypi.mirrors.ustc.edu.cn/simple/
Installation à partir de fichiers locaux
Pour installer un module depuis un fichier .whl ou .tar.gz, naviguez jusqu'au répertoire du fichier via l'explorateur, ouvrez l'invite de commandes à cet emplacement, et lancez :
pip install fichier_extension.whl
Résolution des erreurs de pip
"pip" n'est pas reconnu comme commande
Cela peut indiquer un problème d'installation ou de configuration des variables d'environnement. Solution temporaire : localisez le dossier Scripts de votre installation Python (par exemple dans C:\Python39\Scripts), ouvrez-y une invite de commandes et réessayez. Pour une solution permanente, ajoutez ce chemin à la variable d'environnement PATH du système.
Si pip n'est pas installé, exécutez :
python -m ensurepip --default-pip
Alternativement, téléchargez le script d'installation depuis https://bootstrap.pypa.io/get-pip.py et lancez :
python get-pip.py
Demande de mise à jour de pip
Si une mise à jour est suggérée lors de l'installation, mettez à jour pip avec :
python.exe -m pip install --upgrade pip
Module introuvable
Vérifiez l'orthographe du module. Pour les modules récents ou peu communs, le miroir utilisé peut ne pas être à jour. Revenez à la source officielle temporairement avec :
pip config unset global.index-url
Assurez-vous également que votre connexion réseau fonctionne et essayez un autre miroir si nécessaire.
Commandes essentielles de pip
Pour lister tous les modules installés :
pip list
Pour obtenir des détails sur un module spécifique :
pip show nom_du_module
Pour désinstaller un module :
pip uninstall nom_du_module
Pour voir les modules avec des mises à jour disponbiles :
pip list --outdated
Pour mettre à jour un module à sa dernière version :
pip install --upgrade nom_du_module