pip 23+ · Python
A mensagem
error: externally-managed-environment
O que significa
Este Python é do sistema operacional ou do Homebrew, e o pip se recusa a escrever nele (PEP 668). Você rodou pip install no interpretador do sistema; a mensagem está pedindo que você crie um ambiente virtual. --break-system-packages faz o que o nome diz e pode deixar arquivos gerenciados pelo apt quebrados, então crie um .venv e instale lá.
A correção
python3 -m venv .venv && source .venv/bin/activate- Impresso por
- pip 23+
- Python
- 18
Um traceback do Python divide a resposta em duas partes — a última linha diz o que deu errado e os quadros acima dizem onde — então ler só a última linha dá o nome e perde o lugar; e nos erros de valor ausente, como NoneType e KeyError, a causa quase sempre está num quadro acima daquele que quebrou.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “error: externally-managed-environment”?
Este Python é do sistema operacional ou do Homebrew, e o pip se recusa a escrever nele (PEP 668). Você rodou pip install no interpretador do sistema; a mensagem está pedindo que você crie um ambiente virtual. --break-system-packages faz o que o nome diz e pode deixar arquivos gerenciados pelo apt quebrados, então crie um .venv e instale lá.
Q. Como corrigir?
python3 -m venv .venv && source .venv/bin/activate — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
pip 23+. Fica em Python e a mensagem tem 2 palavras.