Si vous avez déjà essayé d’exécuter Python sur Windows et que vous avez été confronté au classique :
'python' is not recognized as an internal or external command
Oui, vous n’êtes pas le seul. Cette frustration survient lorsque Windows ne trouve pas l’exécutable Python dans le PATH de votre système. C’est comme si on lui disait : « J’ai installé Python, mais j’ai oublié de vous indiquer son emplacement.» La bonne nouvelle, c’est que résoudre ce problème est généralement assez simple : vous pouvez exécuter Python et pip depuis n’importe quel terminal sans avoir à saisir le chemin complet du dossier à chaque fois. C’est un vrai plus.
Dans ce guide, vous trouverez quelques méthodes efficaces pour faire reconnaître Python. Que vous ayez installé Python depuis python.org, utilisé le Microsoft Store ou simplement fait une erreur lors de l’installation, voici une solution qui vous permettra de retrouver une ligne de commande fonctionnelle. De plus, nous vous expliquerons comment vérifier le bon fonctionnement de votre installation et éviter les erreurs courantes qui peuvent vous perturber.
Pourquoi la commande « python » est bloquée
Cela se produit généralement parce que Windows recherche les programmes dans la variable d’environnement PATH. Si le répertoire de Python n’est pas inclus, la saisie pythondans votre terminal… s’arrête. Introuvable. Cela peut se produire si vous n’avez pas coché la case pour ajouter Python à PATH lors de l’installation, ou si un problème est survenu en cours de route.
C’est un peu étrange, mais Windows aime qu’on lui indique explicitement où se trouvent les programmes. Pour résoudre ce problème, il faut donc généralement mettre à jour PATH ou utiliser le lanceur Python (py.exe), qui gère mieux les versions multiples et ne nécessite pas de modifier les variables d’environnement à chaque fois.
Comment résoudre le problème « Python non reconnu » sous Windows
Méthode 1 : utilisez l’installateur Python pour l’ajouter automatiquement au chemin d’accès (meilleure option)
C’est sans aucun doute le plus simple. Si vous avez installé Python depuis python.org, le programme d’installation peut effectuer le gros du travail, notamment en ajoutant Python à votre chemin d’accès lors de l’installation.
- Téléchargez le dernier programme d’installation depuis python.org.
- Exécutez le programme d’installation. Lorsqu’il s’ouvre, assurez-vous de cocher la case « Ajouter Python 3.x au chemin » en bas avant de cliquer sur « Installer maintenant ». Windows intègre parfois cette case à cocher, alors ne la ratez pas.
- Terminez l’installation. Une fois l’installation terminée, fermez le programme d’installation.
- Ouvrez un nouveau terminal (invite de commande ou PowerShell) et tapez :
python --version pip --version where python where pip Si tout est correctement configuré, vous devriez voir votre version de Python et celle de pip sans erreur. Sur certaines configurations, il se peut que les commandes ne soient pas reconnues la première fois ; essayez donc de fermer le terminal et d’en ouvrir un nouveau.
Méthode 2 — Ajouter manuellement Python à votre chemin d’accès utilisateur (aucun administrateur requis)
Ceci est valable si vous n’avez pas sélectionné l’option PATH lors de l’installation, ou si vous l’avez perdue. Vous pouvez ajouter les répertoires vous-même, en modifiant simplement l’environnement Windows. Attention, cela n’affecte que votre compte utilisateur, et non tous les utilisateurs du système. Aucun droit d’administrateur requis, c’est parfait.
- Appuyez sur Win + R, saisissez
sysdm.cpl, puis appuyez sur Entrée. La fenêtre Propriétés système s’ouvre. - Passez à l’ onglet Avancé et cliquez sur Variables d’environnement…
- Sous Variables utilisateur, recherchez et sélectionnez Chemin, puis cliquez sur Modifier.
- Cliquez sur Nouveau et collez dans votre répertoire d’installation Python, comme :
C:\Users\\AppData\Local\Programs\Python\Python311 Et n’oubliez pas le dossier Scripts, où se trouvent pip et d’autres outils :
C:\Users\\AppData\Local\Programs\Python\Python311\Scripts - Utilisez le bouton Déplacer vers le haut pour hiérarchiser ces entrées si nécessaire.
- Cliquez sur OK sur toutes les fenêtres, puis redémarrez votre terminal.
- Vérifiez si cela réussit avec les mêmes commandes que précédemment :
python --version pip --version where python where pip Attention : évitez les erreurs courantes, comme l’ajout inutile d’une barre oblique inverse ( …\Python311non, …\Python311\d’accord !), et vérifiez qu’aucun chemin non valide ne subsiste dans votre variable PATH. Windows peut être impitoyable si vous laissez des entrées incorrectes.
Méthode 3 — Gérer les installations Python du Microsoft Store avec des alias d’application
Si vous avez obtenu Python depuis le Microsoft Store, il s’appuie souvent sur des alias d’exécution d’applications : ce sont comme des raccourcis que le système d’exploitation configure, mais ils peuvent parfois gêner ou entrer en conflit avec votre PATH.
- Ouvrez les paramètres Windows et recherchez Gérer les alias d’exécution des applications.
- Recherchez les entrées pour
python.exeetpython3.exe. Désactivez-les ou activez-les si nécessaire ; elles peuvent parfois forcerpythonl’ouverture du Store ou provoquer d’autres problèmes. - De plus, assurez-vous que votre CHEMIN utilisateur inclut :
C:\Users\\AppData\Local\Microsoft\WindowsApps Une fois configuré, redémarrez votre terminal et réessayez avec python --version. La reconnaissance est instantanée si le positionnement est correct. Parfois, cela ne fonctionne qu’après un redémarrage ou une déconnexion/reconnexion.
Méthode 4 — Utiliser le lanceur Python (idéal pour plusieurs versions de Python)
Le lanceur Python (py.exe) s’installe automatiquement lors de l’installation depuis python.org. Il vous permet d’exécuter différentes versions de Python sans avoir à modifier constamment le chemin d’accès. Si vous jonglez avec plusieurs versions de Python, c’est une solution pratique.
- Vérifiez si vous pouvez l’appeler :
py --version Si cela renvoie une version, c’est parfait. Vous pouvez ensuite exécuter des versions Python spécifiques, comme :
py -3 py -3.11 py -2.7 Vous souhaitez créer un environnement virtuel ? C’est facile :
py -3.11 -m venv myenv myenv\Scripts\activate python --version Astuce bonus : utilisez-le py --listpour voir tous les environnements d’exécution Python détectés. C’est idéal pour gérer plusieurs projets sans modifier votre PATH à chaque fois. Plus de détails dans la documentation officielle de Python.
Conseils de dépannage rapide
Toujours rien ? Exécutez ces commandes pour vérifier :
where python where python3 where py Et vérifiez également pip :
pip --version where pip Si Python ouvre le Microsoft Store au lieu de votre installation locale, le problème vient probablement du paramètre Alias d’application. Désactivez-le dans Paramètres → Applications → Applications et fonctionnalités → Applications et fonctionnalités → Gérer les alias d’exécution d’application.
Et bien sûr, essayez de fermer complètement votre terminal et de le rouvrir après avoir apporté des modifications. Parfois, Windows a simplement besoin d’un redémarrage pour reconnaître les nouvelles variables d’environnement.
Conclure
La plupart des erreurs « Python non reconnu » sont dues à des erreurs de configuration du chemin d’accès ou à des problèmes d’alias d’application. Cocher la case du chemin d’accès du programme d’installation, modifier manuellement les variables d’environnement ou activer/désactiver les raccourcis d’application suffit généralement. L’essentiel est de s’assurer que Windows sait exactement où trouver Python.
Une fois que tout est configuré, votre vie en ligne de commande devient considérablement plus facile : plus besoin de saisir de longs chemins ou de réinstaller Python pour la troisième fois.