Como adicionar o Python ao caminho (path) do sistema?

Como Adicionar o Python ao PATH

por Ian Currie

Você pode precisar adicionar o Python ao PATH se você instalou o Python, mas digitar python no prompt de comando não funciona. Você pode receber uma mensagem dizendo que o termo python não é reconhecido ou pode acabar executando a versão errada do Python.

Uma solução comum para esses problemas é adicionar o Python à variável de ambiente PATH. Neste tutorial, você aprenderá como adicionar o Python ao PATH. Você também aprenderá sobre o que é o PATH e por que o PATH é essencial para que programas como o prompt de comando possam encontrar sua instalação do Python.

Observação: Um caminho é o endereço de um arquivo ou pasta no seu disco rígido. A variável de ambiente PATH, também referida apenas como PATH ou Path, é uma lista de caminhos para diretórios que seu sistema operacional mantém e usa para encontrar scripts e programas executáveis.

As etapas que você precisará seguir para adicionar algo ao PATH dependerão significativamente do seu sistema operacional (SO), portanto, pule para a seção relevante se estiver interessado apenas neste procedimento para um SO.

Observe que você pode usar as seguintes etapas para adicionar qualquer programa ao PATH, não apenas o Python.

Como Adicionar o Python ao PATH no Windows

O primeiro passo é localizar o diretório em que o executável Python desejado está localizado. O caminho para o diretório é o que você adicionará à variável de ambiente PATH.

Para encontrar o executável Python, você precisará procurar por um arquivo chamado python.exe. O executável Python pode estar em um diretório em C:\Python\ ou na sua pasta AppData\, por exemplo. Se o executável estivesse em AppData\, então o caminho geralmente seria algo como:

C:\Users\<USUÁRIO>\AppData\Local\Programs\Python

No seu caso, a parte <USUÁRIO> seria substituída pelo nome de usuário atualmente logado.

Se você estiver tendo dificuldades para encontrar o executável correto, pode usar o recurso de pesquisa do Windows Explorer. O problema com a pesquisa integrada é que ela é dolorosamente lenta. Para realizar uma pesquisa rápida e completa de sistema para qualquer arquivo, uma ótima alternativa é o Everything:

Os caminhos destacados em amarelo, ou seja, aqueles em \WindowsApps e \Python310, seriam candidatos ideais para adicionar ao PATH, pois parecem ser executáveis ​​no nível raiz de uma instalação. Os destacados em vermelho não seriam adequados porque alguns são parte de um ambiente virtual - você pode ver venv no caminho - e outros são atalhos ou instalações internas do Windows.

Também é possível encontrar executáveis ​​do Python que estão instalados dentro da pasta de um programa diferente. Isso ocorre porque muitos aplicativos incluem sua própria versão do Python neles. Essas instalações empacotadas do Python também não seriam adequadas.

Após localizar o executável do Python, abra o menu Iniciar e pesquise a entrada “Editar as variáveis ​​de ambiente do sistema”, que abrirá uma janela “Propriedades do Sistema”. Na guia “Avançado”, clique no botão “Variáveis ​​de ambiente”. Lá você verá variáveis ​​“Usuário” e “Sistema”, que poderá editar:

Na seção intitulada “Variáveis ​​de ambiente do Usuário”, clique duas vezes na entrada que diz “Path”. Outra janela será aberta mostrando uma lista de caminhos. Clique no botão “Novo” e cole o caminho para o diretório do executável Python. Certifique-se de que o caminho esteja listado corretamente e clique em “OK” para salvar as alterações.

Agora você pode abrir o prompt de comando e digitar python. O Python deve ser reconhecido e o REPL do Python deve ser iniciado.

Como Adicionar o Python ao PATH no Linux e macOS

Adicionar o Python ao PATH no Linux e no macOS é um processo semelhante. Você precisará editar o arquivo de perfil do seu shell.

No macOS, o shell padrão é o bash, enquanto no Linux, há várias opções, como o bash, o zsh e o fish. As etapas a seguir assumem o uso do bash, mas você pode ajustá-las de acordo com o seu shell.

Abra o terminal e execute o seguinte comando para abrir o arquivo de perfil do seu shell:

nano ~https://codemdd.io/.bash_profile

Dentro do arquivo, adicione a linha a seguir, substituindo python3 pelo comando correto para o Python no seu sistema:

export PATH="https://codemdd.io/usrhttps://codemdd.io/localhttps://codemdd.io/binhttps://codemdd.io/python3:$PATH"

Pressione Ctrl + X para sair do editor, confirme que deseja salvar as alterações e pressione Enter para confirmar o nome do arquivo.

Agora reinicie o terminal ou execute o seguinte comando para aplicar as alterações sem reiniciar:

source ~https://codemdd.io/.bash_profile

Após a reinicialização do terminal ou a execução do comando acima, você pode digitar python no terminal e o Python deve ser reconhecido e o REPL do Python deve ser iniciado.

Compreensão do que é o PATH

O PATH é uma variável de ambiente presente no seu sistema operacional que contém uma lista de diretórios em que seu sistema procura por comandos executáveis. Quando você digita um comando no seu terminal ou prompt de comando, o sistema percorre cada diretório listado no PATH em ordem, procurando um arquivo executável com o mesmo nome do comando. Quando um arquivo executável é encontrado, o sistema o inicia e executa o comando.

Por exemplo, ao digitar python no terminal, o sistema percorrerá cada diretório listado no PATH e procurará por um arquivo executável chamado python. Quando encontrar o arquivo, ele iniciará o interpretador Python e você poderá começar a executar comandos em Python.

Entender o PATH é fundamental para garantir que o sistema possa encontrar a instalação correta do Python quando você digitar python no terminal ou prompt de comando.

Compreendendo a Importância da Ordem no PATH

A ordem dos diretórios listados no PATH é importante. Quando você digita um comando, o sistema percorre cada diretório no PATH da esquerda para a direita. Se dois diretórios tiverem arquivos executáveis com o mesmo nome, o sistema iniciará o arquivo no diretório que aparece primeiro no PATH. Portanto, se você tiver várias instalações do Python em diferentes diretórios e quiser usar uma versão específica, certifique-se de que o diretório com essa versão seja listado primeiro no PATH.

Gerenciando seu PATH em Sistemas baseados em UNIX

Em sistemas baseados em UNIX, como Linux e macOS, é possível gerenciar o PATH adicionando ou removendo diretórios usando o arquivo de perfil do shell.

No Linux, um arquivo de perfil comum é o ~https://codemdd.io/.bashrc. No macOS, é comum usar o ~https://codemdd.io/.bash_profile ou ~https://codemdd.io/.bashrc. Dependendo do seu shell, você pode precisar editar um ou ambos esses arquivos.

Para adicionar um diretório ao PATH, você pode adicionar a seguinte linha ao seu arquivo de perfil, substituindo <diretório> pelo diretório desejado:

export PATH="$PATH:<diretório>"

Para remover um diretório do PATH, você pode usar a opção - com o comando unset seguido do nome do diretório. Por exemplo, para remover o diretório https://codemdd.io/usrhttps://codemdd.io/localhttps://codemdd.io/bin do PATH, você pode executar o seguinte comando:

unset PATH https://codemdd.io/usrhttps://codemdd.io/localhttps://codemdd.io/bin

Após fazer alterações no arquivo de perfil, reinicie o terminal ou execute o comando source seguido do arquivo de perfil para aplicar as alterações.

Conclusão

Adicionar o Python ao PATH é essencial para garantir que o sistema operacional possa encontrar sua instalação correta do Python. Isso permite que você execute comandos Python em qualquer diretório do seu sistema sem precisar especificar o caminho completo para o executável do Python.

Neste tutorial, você aprendeu como adicionar o Python ao PATH no Windows, Linux e macOS. Lembre-se de que as etapas podem variar dependendo do seu sistema operacional e do seu shell, portanto, consulte as seções relevantes para obter instruções específicas. Agora você deve ser capaz de executar comandos Python com facilidade no seu ambiente de desenvolvimento.

Revisão:

• Adicionou-se uma explicação sobre o que é o PATH
• Incluiu-se informações sobre a importância da ordem dos diretórios no PATH
• Adicionou-se seções sobre a gestão do PATH em sistemas UNIX
• Aprofundou-se as informações sobre como adicionar o Python ao PATH no Windows, Linux e macOS
• Adicionou-se um resumo das principais informações aprendidas no tutorial

Esperamos que este tutorial tenha sido útil e que você agora possa configurar corretamente o PATH para executar seus comandos Python com tranquilidade em qualquer diretório do seu sistema.