“'python' is not recognized as an internal or external command"aparece quando o Windows não consegue encontrar o executável do Python no PATH. Adicionar os diretórios corretos - ou usar o Python Launcher - permite executar Python e pip a partir de qualquer terminal sem caminhos completos.
Referência: A orientação oficial sobre PATH, a opção do instalador e o Python Launcher está na documentação do Python em “Usando Python no Windows”. Consulte a documentação da Python Software Foundation em docs.python.org.
O que você precisa
- Windows 11 com instalação do Python (em python.org ou Microsoft Store).
- Direitos de administrador somente se modificar variáveis de todo o sistema; alterações no nível do usuário não requerem administrador.
- Uma nova sessão de terminal após qualquer alteração de PATH.
Método 1 – Use o instalador oficial para adicionar PATH (recomendado)
Por que isso funciona:O instalador python.org pode definir PATH para você, evita erros de digitação comuns e também adiciona a pasta Scripts que o pip usa. O mesmo instalador pode “Modificar” uma instalação existente para adicionar PATH posteriormente. A documentação do Python indica a opção “Adicionar Python ao PATH” na primeira página do instalador e permite alterná-la após a instalação.
Etapa 1:Execute o instalador do Python em python.org.
Etapa 2:Clique em Instalar agora ou Personalizar instalação se estiver instalando do zero.
Etapa 3:Marque Adicionar python.exe ao PATH na primeira página.
Etapa 4:Conclua a instalação.
Etapa 5:Feche e reabra o Prompt de Comando ou PowerShell.
Etapa 6:Verifique se Python e pip estão disponíveis.
python --version
pip --version
where python
where pip
Dica:Se o Python já estiver instalado, execute novamente o instalador, escolha Modificar, habilite Adicionar python.exe ao PATH, finalize e reabra seu terminal. Para obter mais informações sobre o comportamento do instalador e PATH, consulte a documentação do Python em docs.python.org (link acima).
Método 2 – Adicionar Python manualmente ao PATH (nível do usuário)
Quando usar:Se você instalou o Python sem ativar o PATH ou está alinhando uma instalação existente. Este método tem como alvo o PATH do usuário, evitando alterações em todo o sistema.
Etapa 1:ImprensaWin+R, tiposysdm.cple pressioneEnter.
Etapa 2:Selecione a guia Avançado e clique em Variáveis de ambiente….
Etapa 3:Em Variáveis de usuário, selecione Caminho e clique em Editar.
Etapa 4:Clique em Novo e adicione seu diretório de instalação do Python (por exemplo:C:Users<you>AppDataLocalProgramsPythonPython311).
Etapa 5:Clique em Novo e adicione o diretório Scripts (por exemplo:C:Users<you>AppDataLocalProgramsPythonPython311Scripts).
Etapa 6:Use Move Up para colocar essas entradas perto do topo para que este Python seja encontrado primeiro.
Etapa 7:Clique em OK em todas as caixas de diálogo para salvar as alterações.
Etapa 8:Feche e reabra o Prompt de Comando ou PowerShell.
Etapa 9:Verifique se os comandos correspondem aos seus caminhos.
python --version
pip --version
where python
where pip
Leitura sugerida:Como corrigir o erro “O Windows não consegue acessar o dispositivo, caminho ou arquivo especificado” no Windows 11
Notas e armadilhas:
- Evite barras invertidas nas entradas (use
C:PathToPython311, nãoC:PathToPython311). - Não insira espaços iniciais; cada entrada deve ser uma linha de caminho limpa.
- Certifique-se de que as entradas PATH anteriores não apontem para pastas inexistentes; diretórios inválidos podem causar um comportamento confuso de resolução.
- Reinicie o shell após as alterações; algumas configurações exigem logout/login.
Método 3 – Corrigir instalações da Microsoft Store com aliases de execução de aplicativos
Quando usar:Se o Python foi instalado através da Microsoft Store. Python baseado em loja depende de “aliases de execução de aplicativos” e do diretório WindowsApps, em vez de edições PATH tradicionais.
Etapa 1:Abra as configurações do Windows e pesquise Gerenciar aliases de execução de aplicativos.
Etapa 2:Ative os botões para a versão do Python que você deseja iniciarpython.exeepython3.exeou desative-os para evitar conflitos com a instalação do python.org.
Etapa 3:Certifique-se de que seu usuário PATH inclua WindowsApps para que o alias resolva:C:Users<you>AppDataLocalMicrosoftWindowsApps.
Etapa 4:Reabra seu terminal e confirme os comandos usando o alias escolhido.
python --version
python3 --version
where python
Dica:Se o alias iniciar a Loja em vez do Python, desative o alias desse comando e confie na instalação do python.org ou use o Python Launcher (py) descrito abaixo.
Método 4 – Use o Python Launcher em vez de editar PATH
Por que considerar isso:O iniciador Python (py.exe) é instalado com compilações python.org e localiza corretamente as versões instaladas por tag, evitando conflitos de PATH. Os documentos oficiais enfatizam a seleção de versão e o comportamento de descoberta do Launcher.
Etapa 1:Verifique a versão do iniciador.
py --version
Etapa 2:Execute explicitamente a versão desejada do Python.
py -3
py -3.11
py -3.10 -m pip --version
Etapa 3:Crie e use ambientes virtuais com o iniciador.
py -3.11 -m venv venv
venvScriptsactivate
python --version
Notas:Você pode listar os tempos de execução detectados compy --liste fixar versões por projeto sem tocar em PATH. Os detalhes são abordados na documentação do Python em “Python Launcher for Windows” em docs.python.org (link uma vez acima).
Verificação rápida e solução de problemas
Etapa 1:Confirme qual executável é executado.
where python
where python3
where py
Etapa 2:Valide pip e scripts.
pip --version
where pip
Etapa 3:Sepythonabre a Microsoft Store, desative o alias de execução do aplicativo correspondente ou confie empypara lançar a versão pretendida.
Etapa 4:Se as alterações não se aplicarem, feche totalmente os terminais e IDEs da GUI ou saia e entre novamente para que o ambiente atualizado seja carregado.
Depois que PATH estiver definido (ou o Launcher estiver em uso), você poderá executar Python e pip em qualquer lugar e evitar caminhos completos. Para configurações de várias versões, prefira o Python Launcher para escolher versões exatas de maneira confiável e manter os projetos isolados com ambientes virtuais.
