Como Adicionar o Caminho Python Facilmente?

[

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 terminal 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 é PATH e por que o PATH é vital para programas como o terminal ser capaz de encontrar a instalação do Python.

Observação: Um path é o endereço de um arquivo ou pasta no seu disco rígido. A variável de ambiente PATH, também chamada apenas de 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.

Os passos que você precisará seguir para adicionar algo ao PATH dependerão muito do seu sistema operacional (SO), por isso, certifique-se de ir para a seção relevante se você estiver interessado apenas neste procedimento para um SO.

Observe que você pode usar os seguintes passos 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ê irá adicionar à variável de ambiente PATH.

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

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

Nesse caso, a parte <USUÁRIO> será substituída pelo nome do usuário atualmente logado.

Se tiver dificuldades para encontrar o executável correto, você pode usar a função de pesquisa do Windows Explorer. O problema com a pesquisa integrada é que ela é muito lenta. Para fazer uma busca rápida e completa por qualquer arquivo no sistema, 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 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.

Você também pode encontrar executáveis 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. Essas instalações embutidas do Python também seriam inadequadas.

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

Na seção “Variáveis de Ambiente do Usuário”, dê um duplo clique na entrada que se chama “Path”. Uma nova janela será aberta mostrando uma lista de caminhos. Clique no botão “Novo” e cole o caminho para o diretório do Python que você encontrou. Certifique-se de incluir uma barra invertida ("") no final do caminho:

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

Clique em “OK” em todas as janelas para fechá-las. Agora, o Python estará adicionado ao PATH do seu sistema.

Para verificar se o Python foi adicionado corretamente ao PATH, abra o prompt de comando (CMD) e digite python. Se você ver o prompt do Python e não receber uma mensagem de erro, isso significa que o Python foi adicionado ao PATH com sucesso.

Como Adicionar o Python ao PATH no Linux e macOS

Nos sistemas operacionais baseados em UNIX, como o Linux e o macOS, o processo para adicionar o Python ao PATH é um pouco diferente do Windows.

Em primeiro lugar, é necessário localizar o diretório em que o Python está instalado. Usando o Terminal, você pode executar o seguinte comando para encontrar o caminho para o diretório Python:

$ which python

Esse comando retornará o caminho completo para o interpretador Python. Anote esse caminho.

Agora, abra o arquivo de configuração do shell correspondente ao seu sistema operacional. No caso do Linux, o arquivo é normalmente ~/.bashrc, enquanto no caso do macOS, é ~/.bash_profile.

Abra o arquivo de configuração do shell usando o editor de texto da sua preferência e adicione a seguinte linha, substituindo <PATH_PYTHON> pelo caminho completo para o diretório Python:

export PATH="<PATH_PYTHON>:$PATH"

Note que é necessário adicionar a linha com o comando export para que a variável PATH seja atualizada.

Salve o arquivo de configuração do shell e feche-o. Para que as alterações tenham efeito, você precisará fechar todas as janelas do Terminal e abrir um novo Terminal.

Para verificar se o Python foi adicionado corretamente ao PATH, abra um novo Terminal e execute o comando python. Se você ver o prompt do Python e não receber uma mensagem de erro, isso significa que o Python foi adicionado ao PATH com sucesso.

Entendendo o que é o PATH

O PATH é uma variável de ambiente que contém uma lista de diretórios em que o sistema operacional procura por executáveis. Quando você digita um comando no terminal, o sistema opera o caminho do PATH para encontrar o executável correspondente.

Sem adicionar o Python ao PATH, o sistema não sabe onde encontrar o executável Python quando você tentar executar o comando python. É por isso que é importante adicionar o Python ao PATH, para que o sistema possa encontrá-lo corretamente.

Compreendendo a Importância da Ordem no PATH

A ordem dos diretórios no PATH é essencial. Quando você digita um comando, o sistema verifica cada diretório no PATH sequencialmente até encontrar o arquivo executável correspondente.

Isso significa que se houver vários diretórios contendo o mesmo nome de executável, o sistema usará o primeiro diretório encontrado no PATH. Por exemplo, se você tiver duas instalações diferentes do Python e adicioná-las ao PATH, apenas a instalação do Python no diretório que aparece primeiro no PATH será usada quando você digitar python no terminal.

Portanto, ao adicionar o Python ao PATH, certifique-se de colocar o diretório correto no início da lista, de acordo com a versão do Python que você deseja usar.

Gerenciando o seu PATH em Sistemas Baseados em UNIX

Em sistemas baseados em UNIX, como Linux e macOS, você também pode gerenciar o PATH por meio do arquivo de configuração ~/.bashrc ou ~/.bash_profile. Isso permite adicionar, remover ou alterar os diretórios no PATH conforme necessário.

Para adicionar um diretório ao PATH, você pode usar o seguinte comando no Terminal:

$ export PATH="<NOVO_DIRETÓRIO>:$PATH"

Substitua <NOVO_DIRETÓRIO> pelo caminho completo para o diretório que deseja adicionar.

Para remover um diretório do PATH, você pode usar o seguinte comando no Terminal:

$ export PATH="${PATH/<DIRETÓRIO_REMOVIDO>:}"

Substitua <DIRETÓRIO_REMOVIDO> pelo diretório que deseja remover.

Conclusão

Adicionar o Python ao PATH é um passo importante para que o sistema possa encontrar corretamente a instalação do Python. Nos sistemas Windows, isso pode ser feito adicionando o diretório do Python às variáveis de ambiente do sistema. Já nos sistemas baseados em UNIX, como o Linux e o macOS, é necessário atualizar o arquivo de configuração do shell.

Certifique-se de seguir as instruções adequadas para o seu sistema operacional e, após adicionar o Python ao PATH, verifique se ele foi configurado corretamente executando o comando python no terminal. Agora você será capaz de executar scripts e programas do Python de forma fácil e rápida.