HowTo :: Instalar PyEnv (Gerenciamento Simples de Versões Python)

Date:
Last Modified:
Reading Time: 3 mins
Section: HowTo
Categories: howto
Tags: linux python pyenv development

Introdução

Gerenciar múltiplas versões do Python em uma única máquina pode ser um pesadelo. Ferramentas do sistema frequentemente dependem de uma versão específica do Python, e atualizá-la pode quebrar seu sistema operacional. PyEnv resolve isso permitindo que você instale e alterne facilmente entre múltiplas versões isoladas do Python.

Neste guia, você aprenderá como:

  1. Instalar o PyEnv e suas dependências de build
  2. Configurar seu shell para usar o PyEnv
  3. Instalar diferentes versões do Python
  4. Gerenciar ambientes virtuais facilmente

1. Estabelecendo o Ambiente de Build

O PyEnv compila o Python a partir do código-fonte. Para fazer isso, você precisa de um conjunto de dependências de build instaladas no seu sistema.

Ubuntu / Debian

1
2
3
4
5

sudo apt update
sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev \
liblzma-dev python-openssl git

Fedora / RHEL

1
2

sudo dnf install make gcc zlib-devel bzip2 zlib-devel readline-devel \
sqlite sqlite-devel openssl-devel tk-devel libffi-devel xz-devel

2. Instalando o PyEnv

A maneira mais fácil de instalar o PyEnv (junto com plugins úteis como pyenv-virtualenv) é usando o instalador automático:

1

curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash

3. Configurando seu Shell

Este é o passo mais crítico. O PyEnv precisa ser carregado no seu ambiente shell para funcionar.

Para Usuários Bash (~/.bashrc)

Adicione as seguintes linhas ao final do seu arquivo ~/.bashrc:

1
2
3

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

Então recarregue seu shell:

1

source ~/.bashrc

Para Usuários Zsh (~/.zshrc)

Adicione as seguintes linhas ao final do seu arquivo ~/.zshrc:

1
2
3

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

Então recarregue seu shell:

1

source ~/.zshrc

4. Uso Básico

Instalando uma Versão do Python

Liste as versões disponíveis:

1

pyenv install --list

Instale uma versão específica (ex: 3.10.4):

1

pyenv install 3.10.4

Alternando Versões

Global: Define a versão padrão do Python para seu usuário.

1
2
3

pyenv global 3.10.4
python --version 
# Saída: Python 3.10.4

Local: Define uma versão do Python APENAS para o diretório atual (cria um arquivo .python-version).

1
2
3
4

cd minha_pasta_projeto
pyenv local 3.9.1
python --version
# Saída: Python 3.9.1 (apenas dentro desta pasta)

5. Usando Ambientes Virtuais

O instalador inclui pyenv-virtualenv, que torna virtualenvs cidadãos de primeira classe.

Crie um virtualenv:

1
2

# Uso: pyenv virtualenv <versao_python> <nome_virtualenv>
pyenv virtualenv 3.10.4 meu-projeto-env

Ative-o automaticamente: Navegue até a pasta do seu projeto e defina a versão local para o nome do seu virtualenv.

1
2

cd minha_pasta_projeto
pyenv local meu-projeto-env

Agora, sempre que você entrar em minha_pasta_projeto, o ambiente virtual será estritamente ativado automaticamente!

6. Mantendo o PyEnv Atualizado

Para atualizar o PyEnv para a versão mais recente posteriormente:

1

pyenv update

Solução de Problemas