Tecnología · GUÍA PRÁCTICA
¿Python muestra ‘externally-managed-environment’? Identifica el intérprete antes de forzarlo
Demuestra qué Python usa pip, separa biblioteca, aplicación CLI y componente del sistema, y verifica la ruta antes de considerar --break-system-packages.
‘externally-managed-environment’ no es una solicitud de permiso. El Python elegido por pip contiene EXTERNALLY-MANAGED y el distribuidor declara que un gestor externo controla el entorno predeterminado.
No borres el marcador ni añadas --break-system-packages primero. Demuestra Python y pip, clasifica biblioteca, CLI o componente del sistema y elige un destino con dueño claro.
Conserva el fallo y demuestra el intérprete
Guarda error y comando completos; registra rutas y versiones de python, python3, pip y pip3, además de sys.executable, sys.prefix y sys.base_prefix. No uses sudo para reunir pruebas.
Ejecuta python -m pip --version con ese intérprete. Si Python y pip pertenecen a instalaciones distintas, corrige PATH, alias, activación o herramienta llamadora antes de instalar.
Lee el marcador como evidencia de propiedad
La especificación rechaza el entorno por defecto solo fuera de venv y con el marcador en la biblioteca estándar. Es una declaración de mantenimiento, no prohibición de toda ruta.
Lee el mensaje y las notas oficiales de la distribución. Debian recomienda pipx para aplicaciones y venv para bibliotecas; otros sistemas pueden usar nombres y rutas diferentes.
Elige la ruta por lo que instalas
Para una biblioteca de proyecto crea .venv y usa su python -m pip; un intérprete explícito demuestra mejor el destino que depender solo de la activación.
Para una CLI usa pipx; para componentes del sistema, agentes o hosts gestionados prefiere el paquete de la distribución o la ruta del propietario de la plataforma.
Mantén la excepción excepcional y reversible
Considera --break-system-packages solo si controlas el ciclo de vida, confirmaste dependencias y puedes reconstruir o revertir; registra comando y destino exactos.
No borres el marcador, sustituyas pip de la distribución ni fijes una excepción global permanente por una instalación. En contenedores usa venv explícito o una imagen diseñada para ello.
Verifica ruta, importación y resultado original
Con el Python elegido imprime __file__ o metadatos y usa command -v para una aplicación. La ruta debe estar en el venv o entorno pipx esperado.
Repite el comando original como el mismo usuario y registra todas las rutas. Si falla, revierte y diagnostica versiones, PATH o herramienta llamadora sin ampliar el destino.
