Domine o Pyenv: Como Gerenciar Múltiplas Versões do Python no Linux sem Quebrar o Sistema

Para quem trabalha com automação, desenvolvimento web ou manutenção de sistemas, o pyenv é uma ferramenta indispensável. No Linux, o sistema operacional geralmente depende de uma versão específica do Python para funcionar (o “System Python”). Tentar alterar essa versão globalmente costuma quebrar utilitários críticos do sistema.

O pyenv resolve isso permitindo que você instale e alterne entre dezenas de versões do Python de forma isolada, sem tocar na versão nativa do Linux.

🛠️ 1. Pré-requisitos (Dependências de Compilação)

Diferente de outros gerenciadores, o pyenv compila o Python diretamente no seu hardware para garantir performance máxima. Por isso, você precisa das ferramentas de build instaladas antes de começar.

No Ubuntu/Debian/Mint, execute:

Bash

sudo apt update; sudo apt install -y build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

📥 2. Instalação Automática

A forma mais prática é usar o instalador automático (pyenv-installer):

Bash

curl https://pyenv.run | bash

Configurando o Shell

Após a instalação, você precisa adicionar o pyenv ao seu arquivo de configuração do terminal (ex: .bashrc ou .zshrc) para que ele seja carregado toda vez que você abrir o terminal. Adicione estas linhas ao final do arquivo:

Bash

export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

Reinicie o terminal ou digite source ~/.bashrc para aplicar as mudanças.

🕹️ 3. Comandos Essenciais para o Dia a Dia

📊 Tabela de Escopo: Global vs. Local vs. Shell

ComandoEscopoIdeal para…
pyenv globalTodo o usuárioDefinir sua versão padrão de uso diário.
pyenv localPasta específicaProjetos que exigem versões antigas ou específicas.
pyenv shellApenas a sessão atualTestes rápidos que não devem persistir.

🧪 4. Isolamento com Pyenv-Virtualenv

Para evitar conflitos de bibliotecas (pip) entre projetos que usam a mesma versão do Python, use o plugin virtualenv:

  1. Criar ambiente: pyenv virtualenv 3.12.2 meu-projeto-ia
  2. Ativar na pasta: pyenv local meu-projeto-ia

Agora, sempre que você entrar nessa pasta, o terminal ativará o ambiente virtual automaticamente.

[!TIP]

Dica de Técnico: Se você notar que o pip install está lento ou falhando em algumas bibliotecas científicas, verifique se você instalou a dependência libffi-dev antes de compilar o Python com o pyenv. Se esqueceu, você precisará desinstalar a versão do Python (pyenv uninstall [versao]) e instalar novamente após corrigir as dependências.

Deixe um comentário