Selon la documentation officielle de Python 3.14, l’installation macOS officielle fournit déjà pip. Si le terminal affiche pourtant « pip : commande introuvable », ne réinstallez donc pas Python immédiatement et n’utilisez pas sudo. Pour un échec de pip sur Mac avec Python 3.14, vérifiez d’abord quel interpréteur répond, créez ensuite un environnement venv, puis appelez pip depuis cet interpréteur.

Symptôme : Python 3.14 est installé, mais pip est absent, ancien ou bloqué.
Solution la plus rapide : identifier le chemin de Python, utiliser python3.14 -m pip, puis installer les paquets dans un venv propre.

Qui doit suivre cette procédure ?

Ce guide s’adresse aux étudiants qui ont déjà installé Python 3.14, mais voient une ancienne version ou une erreur dans le terminal. Il convient aussi aux débutants confrontés à externally-managed-environment, Permission denied, à un échec SSL ou à une compilation de paquet.

Vous pouvez l’utiliser sur votre Mac personnel, sur une machine distante ou sur un ordinateur d’école dont les droits sont limités. L’objectif n’est pas de réparer tous les environnements à n’importe quel prix : il faut savoir quand préserver le système et quand repartir dans un environnement propre.

Commencez par le chemin réellement utilisé

Imaginez que Python soit une salle de classe et que PATH soit le panneau qui indique la porte. Vous pouvez avoir plusieurs salles sur le même Mac, mais le terminal n’entre pas forcément dans celle que vous pensez. Une installation récente de Python 3.14 peut donc coexister avec une version plus ancienne.

Le premier cas classique ressemble à ceci : votre cours demande l’installation de requests, mais le terminal répond que pip n’existe pas. La tentation consiste à télécharger un script trouvé sur un forum. C’est précisément ce qu’il faut éviter.

Ouvrez Terminal et observez les réponses de ces commandes :

python3 --version
python3 -c "import sys; print(sys.executable)"
python3 -m pip --version

La documentation de la commande pip confirme que pip peut être appelé comme module de l’interpréteur. Cette méthode est plus fiable que de taper simplement pip, car elle vérifie que pip appartient au Python invoqué.

Si votre cours exige précisément Python 3.14, comparez ensuite avec :

python3.14 --version
python3.14 -c "import sys; print(sys.executable)"
python3.14 -m pip --version

À la date de référence de ce guide, Python 3.14.7 est une version de maintenance publiée de la série 3.14. Vérifiez toujours la page officielle de Python avant de conclure qu’une version locale est la plus récente. Le point important ici n’est pas seulement le numéro affiché : c’est la cohérence entre la version, le chemin et pip.

Pourquoi Python 3.14 est-il installé, mais pip reste-t-il introuvable sur Mac ?

Trois situations sont souvent confondues :

  • Python fonctionne, mais le raccourci pip n’est pas présent dans votre PATH.
  • Le fichier pip existe, mais il appartient à une autre installation de Python.
  • pip est bien associé à Python 3.14, mais le shell ou l’éditeur utilise encore un ancien chemin.

Si python3.14 -m pip --version affiche une version de pip et un chemin cohérent, pip n’est probablement pas absent. Utilisez cette forme pour la suite :

python3.14 -m pip install nom-du-paquet

Ne cherchez pas à rendre immédiatement pip universel dans tout le système. Pour un projet étudiant, la commande versionnée est plus explicite et limite les erreurs de routage.

Réparez pip sans toucher au système global

Il faut distinguer trois erreurs, car elles ne se corrigent pas de la même manière.

Pip est réellement indisponible

Si Python 3.14 répond, mais que python3.14 -m pip --version échoue, consultez d’abord la documentation officielle de ensurepip. Ce module est prévu pour amorcer ou restaurer pip dans certaines installations Python.

Vous pouvez vérifier la possibilité prévue par votre installation avec :

python3.14 -m ensurepip --version

Si cette commande indique qu’ensurepip est disponible, suivez la procédure documentée par Python, puis contrôlez le résultat :

python3.14 -m pip --version
python3.14 -c "import pip, sys; print(sys.executable); print(pip.__file__)"

Le résultat attendu est concret :

  • pip affiche sa version ;
  • le chemin de pip se trouve dans l’environnement associé à Python 3.14 ;
  • sys.executable correspond au Python que vous venez de tester.

N’exécutez pas un installateur récupéré sur un site inconnu. Si ensurepip n’est pas disponible ou si l’installation a été administrée par votre école, demandez à l’administrateur de remettre l’environnement en état au lieu de modifier les répertoires protégés.

Pip existe, mais le shell ne le trouve pas

Dans ce cas, la réparation la plus sûre reste :

python3.14 -m pip --version

Vous pouvez ensuite continuer avec :

python3.14 -m pip install requests

Cette solution ne supprime pas forcément le problème esthétique de la commande pip, mais elle permet de travailler avec le bon interpréteur. Pour un débutant, c’est préférable à une modification hasardeuse du fichier de configuration du shell.

Pip pointe vers l’ancienne installation

Si pip --version et python3.14 -m pip --version affichent des chemins différents, ne réinstallez aucun paquet. Vous avez identifié un conflit entre installations. Gardez le chemin retourné par sys.executable, puis créez un environnement isolé à partir de Python 3.14.

Créez un venv avant d’installer les dépendances

Un venv est comparable à un bureau individuel dans une salle commune. Vous pouvez y poser les outils de votre projet sans déplacer le matériel utilisé par les autres cours ou par macOS.

Placez-vous dans le dossier du projet, puis exécutez :

python3.14 -m venv .venv
source .venv/bin/activate
python -m pip --version

La documentation officielle de venv décrit cette méthode d’isolation. Une fois l’environnement activé, le début de votre invite de commande affiche généralement un indicateur lié à .venv. Le test essentiel reste le chemin :

python -c "import sys; print(sys.executable)"

Le chemin doit se terminer par quelque chose qui ressemble à .venv/bin/python. Ne retenez pas seulement l’apparence de l’invite : vérifiez l’interpréteur.

Installez alors la dépendance du cours dans ce venv :

python -m pip install requests

Vous pouvez remplacer requests par le paquet réellement demandé. L’usage de python -m pip évite de mélanger pip global et pip local.

Pour quitter l’environnement :

deactivate

Pour le retrouver lors d’une prochaine session, revenez dans le dossier du projet et activez-le de nouveau :

source .venv/bin/activate

Le message externally-managed-environment signifie-t-il que pip est cassé ?

Non. Ce message indique généralement que l’environnement Python global est géré par un autre outil ou par le système. La spécification Python Packaging sur les environnements gérés extérieurement explique pourquoi l’installation globale peut être bloquée afin d’éviter de casser des composants existants.

La bonne réaction pour un exercice est de créer un .venv, pas de forcer l’installation. Évitez :

sudo pip install nom-du-paquet

N’essayez pas non plus de supprimer un marqueur de gestion ou de modifier un dossier protégé. Vous pourriez résoudre une ligne d’erreur tout en rendant inutilisable une autre partie du cours.

Traitez séparément les certificats et le réseau

Un téléchargement qui échoue n’est pas toujours un problème de pip. Le message peut signaler un certificat, un domaine inaccessible, un proxy, une interruption temporaire ou une restriction du réseau de l’établissement.

Commencez par noter le texte exact de l’erreur. Puis vérifiez :

  • si un navigateur ouvre normalement les pages Python et PyPI ;
  • si le problème apparaît sur un autre réseau autorisé ;
  • si un proxy de l’école doit être configuré officiellement ;
  • si la date et l’heure du Mac sont correctes ;
  • si la même commande échoue dans le venv et hors du venv.

La page officielle consacrée à Python sur macOS indique notamment les étapes liées aux certificats de l’installateur officiel. Suivez cette documentation lorsque votre installation Python vient de Python.org.

Ne désactivez pas la vérification SSL avec une option trouvée dans une réponse de forum. Ne remplacez pas un certificat par un fichier téléchargé au hasard. Sur un ordinateur administré, ne contournez pas la politique réseau de l’école. Si une autre connexion autorisée permet l’installation, utilisez-la pour confirmer que le problème vient du réseau et non de votre environnement Python.

Un ordinateur d’école sans droits administrateur peut-il utiliser pip ?

Oui, souvent, si vous installez les paquets dans un venv situé dans votre espace utilisateur. Vous devez toutefois respecter les règles de l’établissement. Si Python lui-même est verrouillé, si le dossier du projet est en lecture seule ou si la connexion vers les dépôts est filtrée, pip ne pourra pas tout résoudre localement.

Le critère d’arrêt est simple : si la commande échoue parce que le dossier n’est pas modifiable, ne demandez pas à pip d’écrire dans un emplacement système. Demandez une installation autorisée ou utilisez temporairement une machine propre.

Vérifiez la compatibilité du paquet avant de le forcer

Une erreur comme « No matching distribution found » ne signifie pas automatiquement que Python est mal installé. Le paquet peut ne pas encore proposer de version compatible avec Python 3.14, votre version de macOS ou l’architecture Apple Silicon.

Pour comprendre la situation, consultez la page officielle du paquet et ses métadonnées sur PyPI. Cherchez notamment :

  • les versions de Python annoncées comme compatibles ;
  • la présence d’une distribution binaire adaptée ;
  • les instructions spécifiques à macOS ;
  • les dépendances système demandées ;
  • la version recommandée par votre cours.

Les formats de paquet expliqués dans la documentation Python Packaging permettent de distinguer une archive source d’un paquet déjà préparé. Un fichier wheel est une sorte de manuel déjà assemblé pour une combinaison donnée de système, de version Python et parfois d’architecture. Si aucune roue compatible n’existe, l’outil peut tenter une construction locale.

La référence sur le format binaire wheel aide à comprendre pourquoi un paquet peut fonctionner sur une machine et échouer sur une autre. Sur Apple Silicon, ne déduisez pas la compatibilité d’un paquet à partir d’un autre : chaque projet doit être vérifié dans sa documentation officielle.

Que faire si un paquet Python échoue à la compilation sur un Mac Apple Silicon ?

Ne désactivez pas les contrôles et ne multipliez pas les options au hasard. Vérifiez d’abord la version du paquet, les balises de wheel disponibles et la version de Python demandée par le cours. Si Python 3.14 est trop récent pour ce paquet, trois options raisonnables existent :

  • choisir une version explicitement compatible ;
  • utiliser la version de Python recommandée par l’enseignant dans un environnement séparé ;
  • attendre la mise à jour officielle du paquet.

Si le cours impose Python 3.14, conservez la commande et le message d’erreur complets. Un paquet incompatible ne devient pas compatible parce que pip est réinstallé.

Faites correspondre VS Code et le terminal

Une installation peut réussir dans le terminal tout en échouant dans VS Code. Cela signifie souvent que l’éditeur utilise un autre interpréteur. Vous réinstallez alors le même paquet dans plusieurs endroits sans corriger la cause.

Après l’activation du venv, obtenez son chemin :

python -c "import sys; print(sys.executable)"

Dans VS Code, sélectionnez exactement cet interpréteur dans la commande de choix de l’environnement Python. Ouvrez ensuite un nouveau terminal intégré et testez un import minimal :

python -c "import requests; print(requests.__version__)"

Si le cours utilise un fichier Python, ajoutez temporairement un test simple :

import requests
print("Import réussi")

Supprimez ce test ou commentez-le après vérification. L’installation est considérée comme correcte seulement si le même projet, le même venv et le même interpréteur fonctionnent dans le terminal et dans l’éditeur.

Validez la réparation avec cette liste

Utilisez cette liste avant de reprendre votre exercice :

  • [ ] python3.14 --version confirme l’interpréteur attendu.
  • [ ] python3.14 -c "import sys; print(sys.executable)" affiche le chemin réellement utilisé.
  • [ ] python3.14 -m pip --version associe pip au bon Python.
  • [ ] Un dossier .venv a été créé dans le projet.
  • [ ] Le venv est activé avant l’installation des dépendances.
  • [ ] python -c "import sys; print(sys.executable)" pointe vers .venv.
  • [ ] Le paquet installé est annoncé comme compatible par sa documentation officielle ou ses métadonnées PyPI.
  • [ ] L’import minimal fonctionne dans le terminal.
  • [ ] VS Code utilise le même interpréteur que le terminal.
  • [ ] Vous avez quitté le venv puis réussi à le réactiver.
  • [ ] Vous savez reproduire l’installation sans modifier les dossiers système.

Si un seul de ces contrôles échoue, arrêtez-vous au niveau correspondant. Une erreur de chemin ne se corrige pas avec une option SSL ; une incompatibilité de paquet ne se corrige pas avec sudo.

Décidez s’il faut continuer sur cet ordinateur

Restez sur votre Mac si Python 3.14 est accessible, si vous pouvez créer un venv et si le réseau autorise les téléchargements. Cette solution vous laisse apprendre le fonctionnement réel de l’environnement.

Cherchez une autre machine si l’ordinateur de l’école interdit toute création de venv, si les certificats sont administrés sans procédure utilisable, si le projet doit être rendu rapidement ou si plusieurs anciennes installations se contredisent. Dans ce cas, conserver l’ordinateur intact vaut mieux que modifier des dossiers protégés jusqu’à perdre l’accès à d’autres cours.

Si vous devez poursuivre temporairement sur macOS à distance, consultez d’abord les options de Mac distant pour un environnement de développement propre. Pour une utilisation consacrée à un projet Python, vous pouvez aussi examiner une solution Mac mini dans le cloud, puis refaire exactement les mêmes contrôles : chemin de l’interpréteur, création du venv, installation du paquet et import minimal.

Un ordinateur local mal configuré cumule trois défauts : droits limités, anciennes installations invisibles et réseau souvent imposé par l’établissement. Une machine virtuelle ou une installation locale bricolée ajoute parfois une quatrième difficulté, celle de la compatibilité matérielle. Si votre objectif est seulement de terminer un cours, louer temporairement un Mac via MACCOME peut donc offrir un environnement plus propre pour refaire la validation du projet sans toucher à l’ordinateur de l’école. Gardez toutefois votre Mac local si vous avez besoin d’un usage permanent, d’interfaces physiques ou d’un travail lourd continu : la location convient surtout à un besoin ponctuel, à un test ou à une échéance de formation.

La règle à retenir pour un échec de pip sur Mac avec Python 3.14 est opérationnelle : vérifiez l’interpréteur, appelez pip avec python -m, isolez chaque projet dans venv, puis contrôlez le réseau et la compatibilité du paquet. Ce chemin résout la majorité des erreurs sans réinstaller Python ni utiliser sudo.