Python é fácil de usar, amigável para iniciantes e poderoso o suficiente para criar software robusto para quase qualquer aplicação. Mas, como qualquer outro software, Python pode ser complexo de configurar e gerenciar.

Neste artigo, veremos como configurar o Python da maneira certa. Você aprenderá como escolher a versão apropriada, como evitar que várias versões se sobreponham e como evitar arestas vivas e possíveis armadilhas ao longo do caminho.

Escolha a versão e distribuição corretas do Python

A qualquer momento, algumas versões diferentes do Python estão recebendo ativamente atualizações ou pelo menos correções de segurança. Você pode pensar que faz sentido escolher a edição mais recente do grupo. No entanto, por uma questão de compatibilidade com módulos de terceiros, é sempre mais seguro escolher uma versão Python que seja uma revisão de ponto importante atrás da atual.

No momento em que este artigo foi escrito, Python 3.12 era a versão mais atual. A aposta segura, então, é usar a atualização mais recente do Python 3.11. Você sempre pode experimentar a versão mais recente de maneira controlada (mais sobre isso mais tarde), mas voltar uma versão garante a melhor compatibilidade com pacotes Python comuns de terceiros.

Python, assim como o Linux, também vem em uma variedade de distribuições. Ao contrário do Linux, porém, o Python oferece uma edição “oficial” de padrão ouro à qual você sempre pode recorrer: CPython, a versão fornecida pela Python Software Foundation em Python.org. Esta é a distribuição mais segura e amplamente compatível, aquela que ninguém é demitido por usar. Você também pode querer investigar outras distribuições Python que abordem casos de uso específicos, mas não as consideraremos aqui.

Uma escolha importante que você pode ser solicitado a fazer, especialmente no Windows, é usar a versão de 32 ou 64 bits do Python. A resposta mais provável é 64 bits, pelos seguintes motivos:

  • A maioria dos sistemas operacionais modernos usa uma edição de 64 bits do Python por padrão. Os usuários do Windows podem executar edições de 32 bits do Python no Windows de 64 bits, mas há um pequeno custo de desempenho.
  • Python de 32 bits e aplicativos de 32 bits em geral podem acessar apenas 4 GB de memória por vez. Os aplicativos de 64 bits não têm esse limite, portanto, muitas ferramentas de análise de dados e aprendizado de máquina para Python funcionam melhor em encarnações de 64 bits. Alguns estão disponíveis apenas em versões de 64 bits.

O apenas O momento em que você deve escolher a versão de 32 bits do Python é se você estiver preso a uma versão de 32 bits do Windows ou se precisar usar um módulo de terceiros que está disponível apenas em uma edição de 32 bits. Como isso acontece com menos frequência a cada dia que passa, 64 bits é a escolha comum.

Como instalar Python no Windows

O Python é instalado no Windows da mesma maneira que qualquer outro aplicativo, por meio de um instalador que o orienta durante o processo de configuração.

Por padrão, o instalador do Python para Windows coloca seus executáveis ​​no arquivo do usuário AppData diretório, para que não exija permissões administrativas. Se você é o único usuário no sistema, você pode querer colocar o Python em um diretório de nível superior (por exemplo C:Python312) para facilitar a localização. O instalador do Windows permite especificar o diretório de destino.

Escolha o instalador Python certo para Windows

Python.org oferece várias encarnações de Python para Windows. Além das versões de 32 bits (“x86”) e 64 bits (“x86-64”) já mencionadas, você pode escolher entre o arquivo zip incorporável, o instalador executável e o instalador baseado na web. Aqui está o que se trata:

  • O instalador executável é apenas um .exe arquivo que executa o processo de configuração do Python. Esta é a escolha padrão fácil e a mais comumente usada.
  • O instalador baseado na web é igual ao instalador executável, exceto que baixa separadamente os bits necessários para realizar a instalação. Isso reduz drasticamente o tamanho do instalador real, mas é claro que requer uma conexão de rede.
  • O arquivo zip incorporável é uma cópia mínima e independente do tempo de execução do Python que cabe em uma única pasta sem dependências. É útil agrupá-lo quando você deseja distribuir um aplicativo Python manualmente ou quando precisa de uma instalação rápida e única do Python para testar algo em tempo real. Mas o zip incorporável não inclui pip ou qualquer outra ferramenta útil que vem com a instalação completa, portanto, é apenas para uso especializado. Veja meu vídeo, Como usar a redistribuição incorporável do Python para criar aplicativos independentes, para ver um exemplo do que você pode fazer com a redistribuição incorporável.

Instale Python usando um gerenciador de pacotes do Windows

Outra opção é usar um dos sistemas de gerenciamento de pacotes do Windows para instalar o Python.

O Windows 11 agora vem pré-carregado com a solução de gerenciamento de pacotes da Microsoft, Winget. (Se você tiver o Windows 10, poderá instalá-lo manualmente.) Você pode instalar as edições oficiais do Python.org do Python em winget especificando uma versão, por exemplo: winget install Python.Python.3.11ou usar winget search Python.Python para descobrir quais versões estão disponíveis. (Veja meu tutorial em vídeo para uma introdução ao uso do Winget.)

Outras ferramentas de gerenciamento de pacotes do Windows também oferecem Python. NuGet, o gerenciador de pacotes do .NET, oferece Python em seu repositório. No entanto, Python é fornecido lá principalmente para ser usado como um componente em um aplicativo .NET, não como uma forma de instalar uma instância autônoma do Python para uso geral. Você provavelmente achará sua instância do Python mais fácil de gerenciar se instalar o Python da maneira normal.

Chocolatey, um sistema de gerenciamento de pacotes mais geral do Windows, também oferece Python. Chocolatey é uma maneira conveniente de executar o instalador do Python e rastrear a presença do tempo de execução da linguagem Python em seu sistema e, portanto, é uma escolha melhor que o NuGet. No entanto, é melhor evitar misturar e combinar instalações do Chocolatey, winget instalações e instalações manuais do Python no mesmo sistema. É melhor escolher uma solução geral de gerenciamento de pacotes e mantê-la.

Como instalar Python no Linux

Como as distribuições Linux diferem significativamente, a maneira típica de instalar o Python no Linux é usar o gerenciador de pacotes da distribuição específica. Ubuntu e Fedora, por exemplo, possuem procedimentos totalmente diferentes para instalação do Python. No Linux (e no macOS), o diretório de destino da instalação geralmente é predeterminado e baseado no número da versão do Python, por exemplo, /usr/bin/python3.X no Linux, ou /usr/local/opt/python/ no Mac.

Outra ferramenta Linux para gerenciar múltiplas instalações Python é o pyenv. Ele permite que você instale várias edições lado a lado do Python e alterne entre elas livremente, em todo o sistema ou por projeto. Observe que pyenv cria cada versão do Python que você instala em seu sistema, portanto, você precisará das dependências de compilação do Python instaladas antecipadamente.

Uma maneira de evitar lidar com as complexidades dos gerenciadores de pacotes Linux é usar um tempo de execução Python em contêiner. Os contêineres são executados isolados do resto do sistema, então você não precisa se preocupar com diferentes tempos de execução do Python atrapalhando uns aos outros. No entanto, se o seu fluxo de trabalho ainda não inclui contêineres, você precisará dedicar tempo e energia para se familiarizar com o Docker. (Observe que você também pode usar Python em contêiner no Windows.)

Como instalar Python no macOS

Tradicionalmente, o macOS vem com uma versão do Python instalada, mas nunca mais recente que o Python 2.7. Isso criou problemas quando o Python 3 chegou, já que as duas versões frequentemente conflitavam. A documentação oficial do Python tem algumas notas nesse sentido, mas não fornece nenhuma recomendação mais detalhada do que garantir que você use o caminho correto para a instância do Python desejada.

Uma maneira comum de gerenciar tempos de execução do Python no macOS é por meio do gerenciador de pacotes Homebrew, um projeto não oficial (ou seja, não criado pela Apple) que se tornou um padrão de fato para gerenciamento de pacotes no Mac. O Homebrew fornece uma interface consistente para baixar, instalar, gerenciar e remover Python e outros aplicativos de linha de comando de terceiros.

Dicas de instalação do Python e armadilhas a serem evitadas

Discutimos os fundamentos da instalação do Python no Windows, Linux e macOS. Vamos concluir com três cenários comuns de instalação que exigem um pouco mais de sutileza.

Como não instalar pacotes Python (e o que fazer em vez disso)

Depois de configurar a instalação básica de uma versão do Python, não comece a instalar pacotes diretamente nele com pip—não, nem mesmo se você planeja usar Python para apenas um projeto. Configure os diretórios do seu projeto, instale ambientes virtuais Python neles e então instalar pacotes nesses ambientes virtuais. Desta forma, a instalação da base permanece limpa.

Para uma maneira de alto nível de gerenciar vários projetos com ambientes virtuais e dependências, consulte o projeto Poetry. Poesia fornece uma ferramenta de linha de comando para gerenciar ambientes virtuais e dependências em alto nível.

Como instalar várias versões do Python lado a lado

A questão mais difícil ao lidar com instalações do Python é como lidar com diferentes versões do Python instaladas lado a lado. Duas regras universais se aplicam aqui:

  • Sempre instale cada versão em um diretório diferente.
  • Certifique-se de que todos os caminhos do sistema estejam configurados para apontar primeiro para a versão que você deseja executar por padrão.

A execução de múltiplas versões do Python é um forte argumento a favor de ambientes virtuais por projeto. Quando o ambiente virtual é ativado, todas as atividades do Python dentro do contexto do projeto são automaticamente direcionadas para a versão correta do Python.

Outra opção para usuários do Windows é o py aplicativo inicializador, que permite controlar qual versão do Python usar quando múltiplos forem instalados. Durante a configuração do Python, você terá a opção de instalar o py launcher, um pequeno executável que permite selecionar (por meio de sinalizadores de linha de comando) qual versão do Python usar para um determinado script. Por exemplo, para executar pip para Python 3.11, você inseriria py -3.11 -m pip.

Como atualizar sua versão Python em um ambiente virtual

Atualizações de revisão menores para Python – por exemplo, Python 3.11.2 para Python 3.11.3 – geralmente são bastante fáceis. No Windows, o instalador detecta a presença da versão existente e a atualiza. No Linux e no macOS, o instalador ou gerenciador de pacotes normalmente faz a mesma coisa.

No entanto, quaisquer ambientes virtuais que você criou também precisarão de atualização; eles não são atualizados automaticamente. Para atualizar o Python em um ambiente virtual, basta navegar até o diretório do ambiente virtual e digitar venv --upgrade. Novamente, observe que isso funciona melhor apenas para atualizações de revisão de pontos menores.

Se você estiver realizando um atualização de revisão de ponto principalcomo Python 3.11 a Python 3.12, sua melhor aposta é usar venv para criar um novo subdiretório de ambiente virtual separado no diretório do projeto, reinstalar quaisquer dependências nele e passar a usar o novo ambiente virtual. A maioria dos IDEs com suporte a Python (por exemplo, Microsoft Visual Studio Code) detectará vários ambientes virtuais em um projeto e permitirá alternar entre eles.