Vous tapez python dans votre terminal, et Windows vous répond qu’il ne trouve pas l’exécutable – parfois en vous proposant d’aller l’installer depuis le Microsoft Store. C’est frustrant, surtout quand vous êtes certain d’avoir installé Python il y a dix minutes. Ce problème touche des milliers d’utilisateurs sous Windows 10 et 11, et la cause est presque toujours la même : une mauvaise configuration de l’environnement système, pas Python lui-même.
Pourquoi Windows affiche-t-il «Python est introuvable»?
Le message complet que vous voyez ressemble à ceci : « Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings. » Traduit en clair, Windows ne sait pas où se trouve l’exécutable python.exe sur votre machine.
Deux situations génèrent ce message. Soit Python n’a jamais été installé correctement. Soit il est bien présent sur le disque, mais Windows ne sait pas où le chercher parce que le chemin d’accès n’est pas déclaré dans les variables d’environnement.
Cette erreur apparaît souvent après une migration vers Windows 11, une réinstallation du système, ou une suppression accidentelle du dossier d’installation. Elle peut aussi surgir quand vous basculez entre plusieurs versions de Python sans nettoyer les anciennes configurations. Le système ne supprime pas automatiquement les références obsolètes.
Le rôle du PATH et des variables d’environnement dans cette erreur
Le PATH est une liste de dossiers que Windows parcourt dans l’ordre chaque fois que vous tapez une commande. Quand vous écrivez python, le système cherche un fichier python.exe dans chacun de ces dossiers, un par un. S’il ne le trouve pas, il affiche l’erreur – ou active un alias Microsoft Store à la place.
Pour afficher votre PATH actuel, ouvrez l’invite de commandes et tapez echo %PATH%. Vous obtenez une liste de chemins séparés par des points-virgules. Si le dossier d’installation de Python n’y figure pas, Windows ne trouvera jamais l’exécutable, quelle que soit la version installée.
La commande where python est encore plus directe : elle vous dit exactement quel fichier python.exe Windows trouve en premier, et où il se trouve. Si elle retourne un chemin dans WindowsApps, vous avez affaire aux alias du Microsoft Store, pas à votre installation réelle.
Un détail souvent ignoré : rouvrir le terminal suffit parfois à résoudre le problème. Quand vous modifiez les variables d’environnement, les sessions PowerShell ou CMD déjà ouvertes ne prennent pas en compte les changements. Fermez tout – terminal, VS Code, PyCharm – et rouvrez une nouvelle session avant de conclure que votre correction n’a pas fonctionné.
Les alias Microsoft Store bloquent Python sur Windows 10 et 11
Windows 10 et 11 incluent une fonctionnalité appelée App Execution Aliases. Concrètement, le système place deux fichiers – python.exe et python3.exe – dans le dossier C:\Users\VotreNom\AppData\Local\Microsoft\WindowsApps. Ces fichiers ne sont pas de vraies installations. Ce sont des redirecteurs vers le Microsoft Store.
Quand vous tapez python, Windows trouve ces alias en premier si le dossier WindowsApps apparaît avant votre vraie installation dans le PATH. Résultat : au lieu d’exécuter votre Python installé, le système ouvre le Store ou affiche le message d’erreur.
Pour désactiver ces alias, allez dans Paramètres → Applications → Alias d’exécution des applications. Vous verrez deux entrées nommées « Installateur d’application – python.exe » et « Installateur d’application – python3.exe ». Désactivez les deux. Après cela, Windows ne trouvera plus ces redirecteurs et cherchera le vrai exécutable dans le reste du PATH.
Cette manipulation ne désinstalle rien. Elle retire simplement la priorité accordée à ces raccourcis. Si Python est correctement installé et que son dossier figure dans le PATH, la commande python fonctionnera normalement dès que vous aurez rouvert un terminal.
Comment corriger le chemin d’accès spécifié introuvable pour Python?
Si le PATH ne contient pas le bon dossier, vous devez l’ajouter manuellement. Python s’installe généralement dans C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\ (le numéro varie selon la version). Pour Python 3.10, par exemple, le chemin est C:\Users\VotreNom\AppData\Roaming\Programs\Python\Python310.
Pour modifier le PATH : cliquez droit sur « Ce PC » → Propriétés → Paramètres système avancés → Variables d’environnement. Dans la section « Variables utilisateur », sélectionnez Path et cliquez sur Modifier. Ajoutez deux entrées : le dossier principal de Python et le sous-dossier Scripts.
C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\Scripts\
Le dossier Scripts est souvent oublié. C’est pourtant lui qui contient pip.exe. Si python --version fonctionne mais que pip retourne une erreur, c’est presque certainement Scripts qui manque dans le PATH.
Autre cause moins connue : la limite historique de 260 caractères pour les chemins Windows. Sur les installations imbriquées dans des dossiers profonds, certains chemins dépassent cette limite et ne sont pas résolus. Depuis Windows 10 version 1607, vous pouvez désactiver cette restriction via la stratégie de groupe locale ou la base de registre, dans la clé HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem, en passant LongPathsEnabled à 1.
Si plusieurs versions de Python coexistent – par exemple 3.10 et 3.13 – vérifiez l’ordre des entrées dans le PATH. Windows utilise la première correspondance trouvée. Placez la version que vous voulez utiliser par défaut en premier.
Python3 à la place de python : quand la commande change selon l’OS
Sur Linux et macOS, python désigne souvent Python 2 (ou rien du tout), tandis que python3 appelle explicitement Python 3. Ce choix de nommage évite les conflits sur les systèmes qui ont longtemps maintenu les deux versions en parallèle. Sous Windows, l’installateur officiel de python.org crée par défaut un exécutable nommé python.exe, sans suffixe.
Quand vous travaillez dans un environnement multiplateforme – scripts partagés entre collègues sous Linux et Windows, pipelines CI/CD, conteneurs Docker – cette différence peut bloquer l’exécution. Un script qui fonctionne avec python3 sur le poste Linux d’un collègue échoue sur votre machine Windows si elle ne connaît pas cette commande.
La solution la plus propre consiste à créer un alias. Dans PowerShell, ajoutez cette ligne dans votre profil ($PROFILE) : Set-Alias python3 python. Sur Windows, cette commande rend python3 équivalent à python. L’inverse – rendre python disponible sous Linux – se règle dans le fichier .bashrc ou .zshrc via alias python=python3.
Les environnements virtuels (venv) normalisent aussi ce comportement. À l’intérieur d’un environnement activé, python et python3 pointent tous les deux vers le même binaire, quelle que soit la plateforme.
Autres facteurs qui empêchent Python de fonctionner correctement
Un antivirus trop restrictif peut bloquer l’exécution de scripts Python, surtout les solutions d’entreprise configurées pour interdire tout binaire non signé présent dans AppData. Windows Defender lui-même peut mettre en quarantaine un script .py s’il contient des patterns jugés suspects. Vérifiez les journaux de votre antivirus avant de conclure à un problème d’installation.
Les fichiers d’installation corrompus constituent une autre cause réelle. Un téléchargement interrompu ou un installateur modifié peut produire une installation partielle où python.exe existe mais où les bibliothèques standard sont absentes. Dans ce cas, python --version fonctionne, mais import os échoue. La solution : désinstaller complètement via le Panneau de configuration, puis réinstaller depuis python.org en vérifiant le hash SHA-256 du fichier téléchargé.
Les éditeurs de code méritent aussi une mention. VS Code, PyCharm ou Sublime Text chargent les variables d’environnement au démarrage. Si vous modifiez le PATH alors que l’éditeur est ouvert, il ne verra pas les changements. Redémarrez l’éditeur après toute modification des variables d’environnement – c’est une étape que beaucoup oublient, et qui explique pourquoi certaines corrections semblent ne rien changer.
Pour les messages « élément introuvable » qui reviennent en boucle sur Windows, la logique de diagnostic est similaire : le système cherche une ressource à un chemin qui n’existe plus ou n’a jamais été correct. Identifier ce chemin via les outils de journalisation système est toujours plus rapide que de réinstaller à l’aveugle.
Maîtriser les commandes système Windows en ligne de commande aide considérablement dans ce type de diagnostic : where, echo, set et setx sont les quatre outils qui permettent de visualiser et corriger les variables d’environnement sans jamais ouvrir l’interface graphique.
Un PATH correct, des alias désactivés, et un terminal relancé : dans neuf cas sur dix, ces trois actions suffisent. Ce n’est pas Python qui est cassé – c’est Windows qui ne sait pas où regarder.