pip 23+ · Python
El mensaje
error: externally-managed-environment
Qué significa
Este Python pertenece al sistema operativo o a Homebrew, y pip se niega a escribir en él (PEP 668). Has hecho pip install contra el intérprete del sistema; el mensaje te está pidiendo crear un entorno virtual. --break-system-packages hace lo que su nombre indica y puede dejar en mal estado archivos gestionados por apt, así que crea un .venv e instala ahí.
El arreglo
python3 -m venv .venv && source .venv/bin/activate- Lo imprime
- pip 23+
- Python
- 18
Un traceback de Python divide la respuesta en dos: la última línea dice qué falló y los marcos de arriba dicen dónde, así que leer solo la última línea te da el nombre y te quita el lugar; y en los errores por valor ausente, como NoneType y KeyError, la causa casi siempre está en un marco superior al que se rompió.
Cómo leer un mensaje de error
- Lee desde la primera línea. Cuanto más abajo, más son las tripas de la herramienta; la causa suele estar arriba.
- Si hay un archivo y un número de línea, empieza ahí: no el marco superior de la pila, sino la línea más alta que nombre un archivo tuyo.
- Busca el mensaje literal, pero quita antes tus rutas y nombres de variables: eso es lo que impide que la búsqueda coincida.
- La misma condición se redacta distinto según la versión. Si los resultados no cuadran, añade el número de versión.
- Antes de pegar un arreglo, comprueba qué descarta. Algunos no se pueden deshacer.
Preguntas frecuentes
Q. ¿Qué significa «error: externally-managed-environment»?
Este Python pertenece al sistema operativo o a Homebrew, y pip se niega a escribir en él (PEP 668). Has hecho pip install contra el intérprete del sistema; el mensaje te está pidiendo crear un entorno virtual. --break-system-packages hace lo que su nombre indica y puede dejar en mal estado archivos gestionados por apt, así que crea un .venv e instala ahí.
Q. ¿Cómo se arregla?
python3 -m venv .venv && source .venv/bin/activate — antes de ejecutarlo, mira arriba qué descarta este comando.
Q. ¿Qué herramienta lo imprime?
pip 23+. Está en Python y el mensaje tiene 2 palabras.