pip 23+ · Python
Le message
error: externally-managed-environment
Ce que cela veut dire
Ce Python appartient au système d'exploitation ou à Homebrew, et pip refuse d'y écrire (PEP 668). Vous avez lancé pip install sur l'interpréteur du système ; le message vous demande de créer un environnement virtuel. --break-system-packages fait ce que son nom annonce et peut laisser des fichiers gérés par apt en mauvais état : créez plutôt un .venv et installez dedans.
Le correctif
python3 -m venv .venv && source .venv/bin/activate- Émis par
- pip 23+
- Python
- 18
Une trace Python coupe la réponse en deux : la dernière ligne dit ce qui a échoué, les cadres au-dessus disent où — ne lire que la dernière ligne donne le nom et fait perdre l'endroit ; et pour les erreurs de valeur absente comme NoneType et KeyError, la cause siège presque toujours dans un cadre au-dessus de celui qui a planté.
Lire un message d’erreur
- Lisez à partir de la première ligne. Plus on descend, plus il s’agit des entrailles de l’outil ; la cause est généralement en haut.
- S’il y a un fichier et un numéro de ligne, commencez là — pas la première image de la pile, mais la ligne la plus haute qui nomme un fichier de vous.
- Cherchez le message tel quel, mais retirez d’abord vos chemins et vos noms de variables : c’est cela qui empêche la correspondance.
- La même situation se formule autrement selon la version de l’outil. Si les résultats sonnent faux, ajoutez le numéro de version.
- Avant de coller un correctif, vérifiez ce qu’il jette. Certains sont irréversibles.
Questions fréquentes
Q. Que veut dire « error: externally-managed-environment » ?
Ce Python appartient au système d'exploitation ou à Homebrew, et pip refuse d'y écrire (PEP 668). Vous avez lancé pip install sur l'interpréteur du système ; le message vous demande de créer un environnement virtuel. --break-system-packages fait ce que son nom annonce et peut laisser des fichiers gérés par apt en mauvais état : créez plutôt un .venv et installez dedans.
Q. Comment le corriger ?
python3 -m venv .venv && source .venv/bin/activate — avant de le lancer, vérifiez plus haut ce que cette commande jette.
Q. Quel outil émet cela ?
pip 23+. Cela relève de Python, et le message compte 2 mots.