Instalando Python no Linux: Guia Completo

Introdução

A maioria das distribuições Linux já vem com Python pré-instalado. Porém, nem sempre é a versão mais recente. Neste guia, vamos cobrir todas as formas de instalar ou atualizar Python no Linux, desde o gerenciador de pacotes até a compilação do código-fonte.

Verificando a versão atual

Antes de instalar, verifique se já tem Python no sistema:

python3 --version

Se o comando retornar uma versão como Python 3.10.x ou superior, você já tem Python instalado. Dependendo da sua necessidade, pode ser suficiente.

Método 1: Gerenciador de pacotes (mais fácil)

Ubuntu e Debian (apt)

O Ubuntu 22.04+ e Debian 12+ já incluem Python 3.10 ou superior. Para instalar ou atualizar:

sudo apt update
sudo apt install python3 python3-pip python3-venv

Para instalar uma versão específica mais recente, use o PPA deadsnakes:

sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.13 python3.13-venv python3.13-dev

Fedora (dnf)

O Fedora geralmente inclui uma versão bem recente do Python:

sudo dnf install python3 python3-pip python3-devel

Para uma versão específica:

sudo dnf install python3.13

Arch Linux (pacman)

O Arch Linux mantém o Python sempre atualizado:

sudo pacman -S python python-pip

openSUSE (zypper)

sudo zypper install python3 python3-pip python3-devel

Método 2: pyenv (recomendado para desenvolvedores)

O pyenv permite instalar e gerenciar múltiplas versões do Python sem interferir no Python do sistema. É a opção mais flexível para desenvolvedores.

Instalando o pyenv

Primeiro, instale as dependências de compilação. No Ubuntu/Debian:

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

No Fedora:

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

Agora instale o pyenv usando o instalador automático:

curl https://pyenv.run | bash

Adicione as seguintes linhas ao seu ~/.bashrc (ou ~/.zshrc se usar Zsh):

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

Recarregue o terminal:

source ~/.bashrc

Usando o pyenv

Listar versões disponíveis:

pyenv install --list | grep "^  3\."

Instalar uma versão específica:

pyenv install 3.13.1

Definir como versão global:

pyenv global 3.13.1

Definir uma versão específica para um projeto:

cd meu-projeto
pyenv local 3.12.5

Isso cria um arquivo .python-version no diretório do projeto.

Método 3: Compilando do código-fonte

Se você precisa de uma versão que não está disponível no gerenciador de pacotes ou no pyenv, pode compilar diretamente.

Instalando dependências

No Ubuntu/Debian:

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

Baixando e compilando

cd /tmp
wget https://www.python.org/ftp/python/3.13.1/Python-3.13.1.tgz
tar -xzf Python-3.13.1.tgz
cd Python-3.13.1

./configure --enable-optimizations --with-ensurepip=install
make -j$(nproc)
sudo make altinstall

Importante: Use make altinstall em vez de make install para não sobrescrever o Python do sistema.

Verifique a instalação:

python3.13 --version

Configurando o pip

Depois de instalar o Python, verifique o pip:

python3 -m pip --version

Se o pip não estiver instalado:

python3 -m ensurepip --upgrade

Para atualizar o pip:

python3 -m pip install --upgrade pip

Criando ambientes virtuais

No Linux, é boa prática usar ambientes virtuais para cada projeto:

python3 -m venv meu_projeto_venv
source meu_projeto_venv/bin/activate

Com o ambiente ativo, instale pacotes normalmente:

pip install flask pandas

Para desativar:

deactivate

Dica: não use sudo com pip

Um erro comum no Linux é usar sudo pip install. Isso instala pacotes globalmente e pode causar conflitos com pacotes do sistema. Sempre use ambientes virtuais ou a flag --user:

pip install --user nome-do-pacote

Solução de problemas

“ModuleNotFoundError: No module named ‘venv’”

No Ubuntu/Debian, o módulo venv precisa ser instalado separadamente:

sudo apt install python3-venv

“python: command not found” (mas python3 funciona)

Muitas distribuições não criam o link python por padrão. Você pode criar manualmente:

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 1

Ou instalar o pacote python-is-python3 no Ubuntu:

sudo apt install python-is-python3

Próximos passos

Com o Python instalado no Linux, configure seu editor de código. Recomendamos o guia Configurando VS Code para Python para ter um ambiente de desenvolvimento completo.