Correção: 'pip' não é reconhecido como um comando interno ou externo

Alguns usuários que tentam instalar pacotes Python usando um relatório da janela Prompt de Comando, vêem o erro “ pip não é reconhecido como um comando interno ou externo ”. Os usuários mais afetados relatam que o problema ocorre mesmo após a instalação da distribuição do Python e a certeza de que o Python é adicionado à variável de caminho. O problema não é específico de um determinado sistema operacional, pois é relatado no Windows 7, Windows 8 e Windows 10.

'pip' não é reconhecido como um comando interno ou externo, programa operável ou arquivo de lote

O que é o PIP?

PiP é um acrônimo recursivo para “ Pip Instala Pacotes ”. É essencialmente um sistema de gerenciamento de pacotes usado para instalar e gerenciar pacotes de software escritos em Python. A maioria dos usuários utiliza o PiP para instalar e gerenciar pacotes Python encontrados no Índice de Pacotes Python .

As últimas versões do Python (Python 2.7.9 e posterior e Python 3.4) incluem Pip por padrão.

O que está causando o 'pip' não é reconhecido como um erro de comando interno ou externo?

Investigamos esse problema analisando vários relatórios de usuários e tentando replicar o problema em nossos computadores. Pelo que reunimos, há vários cenários conhecidos para acionar essa mensagem de erro específica:

  • A instalação do PIP não é adicionada à variável do sistema - Para poder executar comandos do Python a partir de uma janela do CMD, você precisará adicionar o caminho da sua instalação do PiP ao seu PATH na variável do sistema. Se você instalou o Python usando o executável de instalação, ele deve ser adicionado automaticamente.
  • A instalação é adicionada incorretamente em seu PATH - É fácil desordenar o PATH se você adicioná-lo manualmente. O espaço adicional ou a falta de um ponto e vírgula antes do novo PATH acabará produzindo o erro.

Se você está atualmente tentando resolver essa mensagem de erro específica que impede o uso do comando Python no CMD, siga os métodos anunciados neste artigo. Todas as possíveis correções abaixo estão confirmadas para funcionar por pelo menos um usuário afetado.

Para obter os melhores resultados, siga os métodos abaixo em ordem até encontrar uma correção que ajude a resolver o problema em seu cenário específico.

Método 1: Verificando se o PIP é adicionado à sua variável PATH

Vamos começar descobrindo onde estamos. Se você não souber se sua instalação PIP é adicionada à sua variável PATH, poderá localizá-la facilmente usando um determinado comando em um prompt do CMD.

Sabendo disso, você estará na direção certa e evitará que você experimente etapas desnecessárias.

Nota: Se você já sabe se o caminho da sua instalação PIP é adicionado à sua variável PATH, vá para os próximos métodos abaixo.

Aqui está um guia rápido para verificar se a instalação PIP já está na sua variável PATH:

  1. Pressione a tecla Windows + R para abrir uma caixa de diálogo Executar. Em seguida, digite “ cmd ” e pressione Enter para abrir o Prompt de Comando.

    Executar diálogo: cmd
  2. Dentro da janela do prompt de comando, digite echo% PATH% e pressione Enter para obter uma listagem com todos os locais adicionados à variável PATH.

    Verificando se a instalação PIP está presente na variável PATH
  3. Se você conseguir encontrar um caminho semelhante ao C: \ Python37 \ Scripts (isso depende da sua versão do Python), isso significa que o caminho de instalação já foi adicionado à sua variável PATH. Nesse caso, você pode pular para os métodos abaixo e ir direto para o Método 4, onde começamos a solucionar problemas relacionados ao caminho da instalação do PiP.

Se você não conseguiu encontrar o caminho da instalação do PiP usando o teste acima, vá para os próximos métodos abaixo (Método 2 e Método 3) para adicionar o PIP à variável de ambiente PATH.

Método 2: Adicionando PIP à variável de ambiente PATH usando a GUI do Windows

Se o Método 1 revelou que a instalação PIP não está configurada para o PATH como uma variável de ambiente e você já instalou a distribuição Python, será necessário fazer isso manualmente.

Depois de concluir o procedimento abaixo, você poderá inserir comandos PiP a partir de uma janela do Prompt de Comando. Aqui está um guia rápido em Adicionando a instalação do PiP à variável de ambiente Path usando a GUI do Windows:

  1. Pressione a tecla Windows + R para abrir uma caixa de diálogo Executar. Em seguida, digite “ sysdm.cpl ” e pressione Enter para abrir a tela Propriedades do sistema .

    Executar diálogo: sysdm.cpl
  2. Dentro da tela Propriedades do sistema, vá para a guia Avançado e clique em Variáveis ​​de ambiente .

    Vá para a guia Avançado e clique em Variáveis ​​de Ambiente
  3. Na tela Variáveis ​​de ambiente, vá para Variáveis ​​do sistema e clique em Caminho para selecioná-lo. Então, com o caminho selecionado, clique no botão Editar… .

    Selecione a entrada Caminho em Variáveis ​​do sistema e clique em Editar
  4. Na tela Editar Variável de Ambiente, clique em Novo e inclua o caminho onde a instalação do PiP está localizada. Para o Python 3.4, o local padrão é C: \ Python34 \ Scripts.

    Adicionando o local de instalação do PiP
  5. Uma vez que o caminho é adicionado, abra uma nova janela do CMD e tente instalar um pacote python que vem com o PiP. Você não deve mais ver o erro “ pip não é reconhecido como um comando interno ou externo ”.

Se você estiver procurando uma maneira mais rápida de adicionar o local de PiP à variável de ambiente, siga o Método 3 .

Método 3: Adicionando PIP à variável de ambiente PATH usando o CMD

Uma maneira mais rápida de configurar a variável de ambiente de caminho PIP é fazer isso diretamente a partir de uma janela CMD. Isso vai lhe poupar algum tempo, mas pode ser um pouco mais intimidante se você não estiver acostumado a usar o terminal.

Aqui está um guia rápido sobre como configurar o ambiente do caminho PiP diretamente de uma janela do Prompt de Comando:

  1. Pressione a tecla Windows + R para abrir uma caixa de diálogo Executar. Em seguida, digite “ cmd ” e pressione Enter para abrir uma janela do prompt de comando.

    Executar diálogo: cmd
  2. Na janela Prompt de Comando, execute o seguinte comando para definir a instalação PIP para a variável de ambiente:
     setx PATH "% PATH%; C: \ Python37 \ Scripts" 

    Nota: tenha em mente que, neste comando, usamos o local padrão do Python 3.7. Se você estiver usando uma versão diferente do Python ou instalou-a em um local personalizado, altere o caminho depois de ' ; ' adequadamente.

  3. Veja se esse método foi executado com sucesso executando um pacote de instalação do Python (um que usa PIP) na mesma janela do CMD. Se você ainda encontrar a mensagem de erro, vá para o próximo método abaixo.

Método 4: Abrindo o pacote Python sem adicionar a variável PiP

Se você está procurando uma maneira de instalar um pacote Python do CMD sem adicionar PiP à variável de ambiente PATH, é possível usar alguns comandos diferentes para instalá-lo. Isso também funciona se você usou os métodos acima para configurar a variável PATH do ambiente, mas ainda está encontrando a mensagem de erro.

Aqui estão algumas maneiras que você pode usar para abrir pacotes de instalação do Python no CMD sem adicionar a variável PIP:

O método curto:

  1. Pressione a tecla Windows + R para abrir uma caixa de diálogo Executar. Em seguida, digite “ cmd ” e pressione Enter para abrir uma janela do prompt de comando.

    Executar diálogo: cmd
  2. Digite os seguintes comandos e certifique-se de alterar o espaço reservado para o seu próprio nome de pacote:
     python -m pip install [nome do pacote] 

    Nota: Altere [packagename] com o nome do pacote que você está tentando instalar.

O método longo:

  1. Abra uma caixa de diálogo Executar pressionando a tecla Windows + R. Em seguida, digite " cmd " e pressione Enter para abrir uma janela do Prompt de Comando.

    Executar diálogo: cmd
  2. Na janela do CMD, use o seguinte comando para navegar até o diretório em que o arquivo .whl do python está localizado.
     cd C: \ python instala 

    Nota: Em nosso exemplo, o pacote de instalação do Python estava localizado em uma pasta chamada instalações python. Adapte este comando para navegar até o diretório onde a roda está localizada.

  3. Em seguida, execute o seguinte comando para instalar o pacote Python usando PiP:
     c: \ python37 \ scripts \ pip.exe install [pacote] .whl 

    Nota: Lembre-se de que você precisa alterar a localização da sua instalação do Python se tiver uma versão mais antiga ou se tiver instalado em um local personalizado. Além disso, certifique-se de alterar o espaço reservado [package] para o nome do seu próprio pacote.

Se esses dois últimos métodos não permitirem que você instale o pacote Python da janela do CMD, siga o último método abaixo, onde garantimos que o PiP está instalado.

Método 5: Garantir que o PiP está incluído na sua instalação do Python

Antes de prosseguirmos e reinstalarmos todo o ambiente Python, vamos ver se o PiP não foi omitido da instalação do Python. Certos instaladores do Python deixarão o PiP fora da instalação padrão.

Felizmente, você pode corrigir isso modificando a instalação do Python e modificando-a para instalar o PIP. Aqui está um guia rápido sobre como fazer isso:

  1. Pressione a tecla Windows + R para abrir uma caixa de diálogo Executar. Em seguida, digite “ appwiz.cpl ” e pressione Enter para abrir Programas e Recursos.

    Executar diálogo: appwiz.cpl
  2. Dentro de Programas e Recursos, clique com o botão direito do mouse na instalação do Python e clique em Alterar .

    Alterar a instalação do Python
  3. Na tela Modify Setup, clique em Modify.

    Clique em Modificar para garantir que o PiP esteja instalado
  4. Na tela Recursos opcionais, marque a caixa associada ao pip e clique em Avançar .

    Modificando a instalação do Python para incluir o PiP
  5. Clique no botão Instalar para fazer as alterações na instalação do Python.

    Mudando a instalação do Python
  6. Depois que a instalação do Python for modificada, abra uma janela do CMD e veja se é possível instalar um pacote do Python com o PiP sem ver o erro “ pip não é reconhecido como um comando interno ou externo ”.

Método 6: Instalando o Python por meio do instalador executável

Se você chegou até aqui sem um resultado, reinstalar o Python junto com seus componentes provavelmente resolverá o erro “ pip não é reconhecido como um comando interno ou externo ”.

A maneira mais fácil de fazer isso é usando o instalador executável do Python. Se você configurá-lo corretamente, ele instalará o PiP automaticamente. Aqui está um guia rápido sobre como fazer isso:

  1. Pressione a tecla Windows + R para abrir uma caixa de diálogo Executar. Em seguida, digite “ appwiz.cpl ” e pressione Enter para abrir Programas e Recursos .

    Executar diálogo: appwiz.cpl
  2. Dentro de Programas e Recursos, role até a lista de programas para encontrar a instalação do Python. Depois de encontrá-lo, clique com o botão direito nele e escolha Desinstalar, depois siga as instruções na tela para removê-lo do seu sistema. Quando a distribuição do Python for removida do seu computador, reinicie sua máquina.

    Desinstalando o Python da sua máquina
  3. Na próxima inicialização, visite este link ( aqui ) e faça o download do instalador executável mais recente do Python de acordo com sua arquitetura do sistema operacional.

    Baixando o instalador executável direito do Python
  4. Abra o executável de instalação e comece certificando-se de que a caixa associada a Add Python to PATH esteja marcada - Isso garante que você possa executar comandos Python no Prompt de Comando. Em seguida, clique em Personalizar instalação .

    Assegure-se de que Python seja adicionado ao PATH e, em seguida, clique em Customize installation
  5. Na janela Recursos opcionais, verifique se a caixa associada ao pip está marcada e clique em Avançar .

    Verifique se o pip está marcado em recursos opcionais
  6. Deixe o local padrão e Opções avançadas e clique em Instalar para iniciar a instalação.

    Instalando o Python
  7. Quando a instalação estiver concluída, reinicie o computador manualmente se você não for solicitado automaticamente.
  8. Na próxima inicialização, veja se o problema foi resolvido ao tentar instalar um pacote Python por meio de uma janela CMD.
  9. Se você ainda estiver vendo o erro " pip não é reconhecido como um comando interno ou externo ", digite o seguinte comando em uma janela do CMD:
     python -m ensurepip --default-pip 

    Nota: Com certas distribuições do Python (particularmente 3.6), é possível que o PiP não seja instalado por padrão. Uma das correções oficiais para isso incluída na documentação é este comando.

Artigos Interessantes