Diagnosticar primeiro se o problema é de instalação do Python ou apenas de localização do pip no sistema.
Usar o comando python -m pip como alternativa imediata, sem precisar alterar nenhuma configuração do Windows.
Ajustar a variável de ambiente PATH quando o Python responde normalmente, mas o pip continua sendo ignorado pelo terminal.
Reinstalar o Python marcando a opção que inclui o programa no PATH quando o ajuste manual não for viável ou não resolver.
Quando o Windows exibe a mensagem informando que “pip” não é reconhecido como nome de cmdlet, de função, de arquivo de script ou de programa operável, o problema quase sempre está relacionado a dois pontos: o Python (e o pip que vem com ele) não está instalado no computador, ou está instalado, mas o sistema não sabe onde encontrar.
Entender qual dessas duas situações se aplica ao seu caso é o primeiro passo para escolher a correção certa.
As seções seguintes tratam cada cenário separadamente, começando pelo diagnóstico e avançando até a confirmação de que o comando voltou a responder.
Verificar se o Python está instalado no Windows
O ponto de partida é confirmar se o Python está realmente instalado e se o próprio sistema reconhece esse comando.
Para isso, abra o Prompt de Comando ou o PowerShell e digite python –version (ou, em algumas instalações, python3 –version).
Se a versão instalada aparecer na tela, o Python está presente e o problema provavelmente está restrito ao pip. Se o terminal responder que o comando python também não é reconhecido, a causa é mais ampla: o Python não está instalado nesse usuário ou nessa sessão, ou também não está acessível pelo PATH.
Nesse segundo caso, a solução passa por instalar o Python a partir do site oficial do projeto, que distribui o instalador para Windows já acompanhado do pip na maioria das versões atuais.
Depois de concluída a instalação, repita a verificação do comando python antes de avançar para os testes do pip, para confirmar que a base está funcionando.
Executar o pip por meio do Python
Quando o comando python funciona, mas pip isoladamente não é reconhecido, existe uma alternativa que não exige alterar nenhuma configuração do sistema: chamar o pip como um módulo do próprio Python.
O comando python -m pip install seguido do nome do pacote tem o mesmo efeito prático de usar o pip diretamente, porque o Python localiza o módulo pip internamente, sem depender de o executável pip estar listado na variável PATH.
Essa abordagem é útil como solução imediata, especialmente quando o ajuste da variável de ambiente não pode ser feito naquele momento.
Ela não substitui a correção definitiva, mas permite continuar instalando pacotes enquanto o ajuste do PATH ou a reinstalação não forem realizados.
Adicionar o Python e o pip à variável de ambiente PATH
Quando o objetivo é fazer o comando pip funcionar diretamente, sem precisar do prefixo python -m, é necessário garantir que a pasta de instalação do Python e a subpasta Scripts, localizada dentro dela, estejam listadas na variável de ambiente PATH do Windows.
É nessa subpasta Scripts que o executável do pip normalmente é instalado.
O procedimento geral segue esta sequência:
Abrir as configurações de variáveis de ambiente do Windows a partir do painel de propriedades do sistema.
Localizar a variável Path na lista de variáveis do usuário ou do sistema.
Editar a variável e adicionar uma nova entrada apontando para a pasta onde o Python foi instalado.
Adicionar outra entrada apontando para a subpasta Scripts dentro dessa mesma pasta de instalação.
Salvar as alterações e fechar todas as janelas de configuração abertas.
Depois de concluir esses passos, é indispensável fechar o terminal que estava aberto e abrir uma nova janela. O Windows só carrega o valor atualizado da variável PATH em sessões de terminal abertas após a alteração; uma janela já aberta continua usando a configuração anterior.
Reinstalar o Python marcando a opção de PATH
Se editar manualmente a variável PATH parecer complexo, resultar em erro de digitação ou simplesmente não resolver o problema, uma alternativa é reinstalar o Python usando o próprio instalador oficial.
Durante a instalação, o assistente apresenta uma opção para adicionar o Python ao PATH automaticamente. Marcar essa opção antes de concluir a instalação faz com que o próprio instalador configure a variável de ambiente, dispensando o ajuste manual descrito na seção anterior.
Para decidir qual caminho seguir em cada situação, a comparação a seguir resume as três abordagens tratadas até aqui:
Método
Quando usar
Exige reiniciar o terminal
python -m pip
Solução imediata, sem alterar o sistema
Não
Ajuste manual do PATH
Quando python funciona e pip deve passar a funcionar sozinho
Sim
Reinstalação com opção de PATH
Quando o ajuste manual falhou ou não é viável
Sim
Como confirmar que o pip voltou a funcionar
Depois de aplicar qualquer uma das correções, abra uma nova janela de terminal e digite pip –version. Se o comando retornar o número da versão instalada e o caminho do executável, o problema foi resolvido e o pip pode ser usado normalmente a partir desse ponto.
Caso o erro de reconhecimento ainda apareça, repita a verificação do comando python –version para confirmar se a base continua correta e revise se a subpasta Scripts foi realmente incluída na variável PATH.
Perguntas frequentes sobre o erro do pip no Windows
O Python está instalado, mas o pip continua sem funcionar. O que fazer?
Nesse caso, o problema normalmente está na variável PATH: a pasta Scripts da instalação do Python não está listada nela. Use python -m pip como solução imediata e, em seguida, ajuste o PATH para corrigir o comando pip diretamente.
O comando python também não é reconhecido. Isso significa o quê?
Significa que o próprio Python não está instalado nessa sessão ou nesse usuário, ou que também não está acessível pelo PATH. A correção começa pela instalação (ou reinstalação) do Python antes de tratar o pip isoladamente.
É possível usar o pip sem alterar a variável PATH?
Sim. O comando python -m pip, seguido da ação desejada, cumpre a mesma função do pip direto, desde que o comando python esteja funcionando normalmente no terminal.
Quando é necessário reinstalar o Python para corrigir o erro?
A reinstalação costuma ser o caminho mais simples quando o ajuste manual da variável PATH não é viável ou não resolveu o problema. O instalador oferece uma opção para configurar o PATH automaticamente durante o processo.
O erro persiste mesmo depois de ajustar o PATH. Por quê?
As causas mais comuns são não ter reaberto o terminal depois da alteração, ou ter apontado a variável para uma pasta diferente daquela em que o Python foi realmente instalado. Confirme o caminho correto e abra uma nova janela de terminal antes de testar novamente.
Qual a diferença entre pip e pip3?
Em muitas instalações recentes do Python no Windows, pip e pip3 apontam para o mesmo executável, já que esses sistemas costumam trazer apenas uma versão do Python instalada. A distinção é mais relevante em sistemas que mantêm versões 2 e 3 do Python simultaneamente, o que não é o cenário padrão no Windows atual.
Construa sua carreira em tecnologia com formações alinhadas ao mercado
Se você quer ingressar ou crescer no mercado da tecnologia, a Allevo Tech oferece formações práticas em áreas de alta demanda, como Engenharia de Software, Ciência de Dados e Inteligência Artificial.
As trilhas são estruturadas para desenvolver competências técnicas e preparar você para os desafios do mercado de trabalho.
Clique no botão abaixo e conheça as formações da Allevo Tech que podem impulsionar a sua trajetória profissional.