Lorsque vous voyez'python' is not recognized as an internal or external commandcette erreur, cela signifie que Windows ne trouve pas l'exécutable Python dans la variable d'environnement PATH.

En ajoutant le bon répertoire au PATH, vous pouvez exécuter Python et pip dans n'importe quel terminal sans indiquer les chemins complets.

Avant de commencer, assurez-vous de disposer des éléments suivants :

Pour des conseils détaillés sur PATH, les options d'installation et Python Launcher, consultez le chapitre « Using Python on Windows » de la documentation officielle de Python (docs.python.org).

Méthode 1 : Utiliser le programme d'installation officiel pour ajouter PATH (recommandé)

L’installateur de python.org peut définir PATH pour vous directement, ce qui évite les erreurs de saisie manuelle, et il ajoute également le dossier Scripts requis pour pip.

Le même installateur peut également être utilisé avec l’optionModifypour ajouter PATH à une installation existante sans réinstaller.

Étapes

Écran d’installation — veillez à cocher l’option PATH :

Si déjà installé, choisissez l’option Modify :

Vérifiez si l'installation a réussi :

python --version
pip --version
where python
where pip

Si vous avez déjà installé Python mais que vous n’avez pas coché l’option PATH à ce moment-là, relancez simplement l’installateur, choisissezModify, puis cochez « Add python.exe to PATH », et rouvrez le terminal une fois l’installation terminée.

Méthode 2 : ajouter manuellement Python à PATH (niveau utilisateur)

Si vous n’avez pas activé l’option PATH lors de l’installation de Python, ou si vous devez modifier uniquement les variables d’environnement de l’utilisateur actuel sans affecter les variables système, vous pouvez modifier PATH manuellement.

Étapes

Étape 1 — Ouvrez Propriétés système via sysdm.cpl :

Étape 2 — Fenêtre des variables d’environnement :

Étape 3 — Modifiez la variable Path :

Étape 4 — Créez une nouvelle entrée de chemin d’installation de Python :

Étape 5 — Ajouter le répertoire Scripts :

Étape 6 — Déplacer les entrées vers le haut pour qu'elles soient trouvées en premier :

Étape 7 — Confirmer et enregistrer toutes les boîtes de dialogue :

Étape 9 — Vérifier le résultat :

python --version
pip --version
where python
where pip

Remarques et pièges courants

Méthode 3 : Corriger les « alias d’exécution d’applications » pour les installations Microsoft Store

Si vous avez installé Python à partir du Microsoft Store, il s’appuie sur les « alias d’exécution d’applications » et le répertoire WindowsApps pour résoudre la commande python, plutôt que sur la modification traditionnelle de PATH.

Étapes

Entrée des paramètres d’alias d’exécution d’applications :

Boutons d’activation des alias python.exe et python3.exe :

Si la saisiepythonouvre Microsoft Store au lieu d’exécuter Python, l’alias pointe vers le Store. Désactivez l’alias pour la version correspondante, installez plutôt la version python.org, ou utilisez le Python Launcher (commande py) décrit ci-dessous.

Méthode 4 : Utiliser Python Launcher au lieu de modifier PATH

Lanceur Python（py.exe) est installé avec les versions de python.org et peut localiser automatiquement les versions de Python installées en fonction des étiquettes, évitant complètement les conflits de PATH.

C'est la solution de gestion multi-versions officiellement recommandée — vous pouvez épingler une version spécifique de Python pour chaque projet sans modifier PATH.

Étapes

Vérifiez la version du lanceur :

py --version

Exécutez explicitement la version de Python souhaitée :

py -3
py -3.11
py -3.10 -m pip --version

Utilisez le lanceur pour créer et utiliser des environnements virtuels :

# 使用指定版本创建虚拟环境
py -3.11 -m venv venv

# 激活虚拟环境
venv\Scripts\activate

# 在虚拟环境中确认 Python 版本
python --version

Notes supplémentaires

Lorsque vous utilisez le Lanceur py, vous pouvez complètement ignorer l'édition manuelle du PATH. Le Lanceur découvre automatiquement toutes les versions de Python installées et vous permet de choisir selon vos besoins — c'est particulièrement pratique pour les développeurs qui ont besoin à la fois de Python 3.10 et 3.12.

Vérification rapide et dépannage

Confirmer quel exécutable est en cours d'exécution

where python
where python3
where py

Vérifier pip et Scripts

pip --version
where pip

Dépannage courant

Résumé

Une fois PATH correctement défini — ou dès que vous commencez à utiliser Python Launcher — vous pouvez exécuter Python et pip de n’importe où sans saisir le chemin complet.

Pour les environnements multi-versions, il est fortement recommandé d’utiliser Python Launcher pour sélectionner précisément les versions, en combinaison avec des environnements virtuels afin de maintenir l’isolation des dépendances pour chaque projet.