Instalando Python no macOS: Tutorial

Introdução

O macOS vem com uma versão do Python pré-instalada, mas geralmente é uma versão antiga ou o runtime fornecido pela Apple, que não deve ser usado para desenvolvimento. Neste tutorial, vamos instalar uma versão atualizada do Python no seu Mac.

Este guia funciona tanto para Macs com processadores Apple Silicon (M1, M2, M3, M4) quanto Intel.

Verificando o estado atual

Abra o Terminal (pressione Cmd + Espaço, digite “Terminal” e pressione Enter) e verifique:

python3 --version

Se retornar Python 3.9.x ou inferior, vale a pena instalar uma versão mais recente.

Método 1: Homebrew (recomendado)

O Homebrew é o gerenciador de pacotes mais popular para macOS. Se você ainda não tem, vamos instalá-lo primeiro.

Instalando o Homebrew

Cole este comando no Terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Siga as instruções na tela. Em Macs com Apple Silicon, o Homebrew é instalado em /opt/homebrew. O instalador mostrará comandos para adicionar o Homebrew ao PATH — execute-os.

Verifique a instalação:

brew --version

Instalando Python com Homebrew

brew install python

Isso instala a versão mais recente do Python 3 junto com o pip. Verifique:

python3 --version
pip3 --version

Atualizando Python com Homebrew

Para atualizar para a versão mais recente no futuro:

brew upgrade python

Instalando uma versão específica

Se você precisa de uma versão diferente da mais recente:

brew install python@3.12

Para usar essa versão:

/opt/homebrew/opt/python@3.12/bin/python3.12 --version

Método 2: Instalador oficial

A Python Software Foundation disponibiliza instaladores gráficos para macOS.

Passo 1 — Baixar o instalador

Acesse python.org/downloads/macos e baixe o instalador universal (macOS 64-bit universal2 installer). Este funciona tanto em Apple Silicon quanto Intel.

Passo 2 — Executar o instalador

1. Abra o arquivo .pkg baixado.
2. Siga as telas do assistente de instalação clicando em “Continuar”.
3. Aceite a licença e clique em “Instalar”.
4. Digite sua senha de administrador quando solicitado.
5. Ao final, clique em “Fechar”.

Passo 3 — Verificar a instalação

python3 --version
pip3 --version

O instalador oficial coloca o Python em /Library/Frameworks/Python.framework/ e cria links em /usr/local/bin/.

Instalando certificados SSL

Depois de usar o instalador oficial, execute o script de instalação de certificados que fica na pasta do Python em Aplicativos. Ou pelo terminal:

/Applications/Python\ 3.13/Install\ Certificates.command

Sem isso, requisições HTTPS podem falhar com erros de certificado.

Método 3: pyenv (para desenvolvedores)

O pyenv é ideal se você precisa alternar entre múltiplas versões do Python.

Instalando o pyenv

brew install pyenv

Adicione ao seu ~/.zshrc (o shell padrão do macOS moderno):

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

Recarregue o terminal:

source ~/.zshrc

Instalando dependências de compilação

brew install openssl readline sqlite3 xz zlib tcl-tk

Usando o pyenv

Instalar uma versão:

pyenv install 3.13.1

Definir como versão global:

pyenv global 3.13.1

Verificar:

python --version

Com o pyenv, o comando python (sem o 3) funciona diretamente.

Definir versão por projeto:

cd meu-projeto
pyenv local 3.12.5

Criando ambientes virtuais

Independente do método de instalação, use ambientes virtuais para isolar projetos:

python3 -m venv meu_projeto
source meu_projeto/bin/activate

Com o ambiente ativo, instale pacotes:

pip install django requests

Para desativar:

deactivate

Dicas para macOS

Não modifique o Python do sistema

O macOS usa Python internamente. Nunca modifique ou remova o Python que veio com o sistema em /usr/bin/python3. Sempre instale uma versão separada para desenvolvimento.

Xcode Command Line Tools

Alguns pacotes Python precisam compilar extensões em C. Instale as ferramentas de compilação:

xcode-select --install

Alias útil

Se você usa Homebrew ou pyenv e quer que python (sem o 3) funcione, adicione ao ~/.zshrc:

alias python="python3"
alias pip="pip3"

Solução de problemas

“xcrun: error: invalid active developer path”

Instale as Xcode Command Line Tools:

xcode-select --install

Conflito entre versões

Se python3 --version mostra uma versão diferente da esperada, verifique qual Python está sendo usado:

which python3

Isso mostra o caminho completo. Se não for o esperado, verifique a ordem dos diretórios no seu PATH.

Problemas com pip no macOS Ventura+

Versões recentes do macOS podem bloquear a instalação global de pacotes. Use sempre ambientes virtuais ou a flag --user:

pip3 install --user nome-do-pacote

Próximos passos

Com o Python instalado no seu Mac, recomendamos configurar o VS Code para Python como ambiente de desenvolvimento.