---
title: "Instalando Python no macOS: Tutorial"
url: "https://python.dev.br/guias/instalando-python-mac/"
markdown_url: "https://python.dev.br/guias/instalando-python-mac.MD"
description: "Como instalar Python no macOS usando Homebrew, instalador oficial ou pyenv. Tutorial completo para Mac com Apple Silicon e Intel"
date: "2025-10-18"
author: ""
---

# Instalando Python no macOS: Tutorial

Como instalar Python no macOS usando Homebrew, instalador oficial ou pyenv. Tutorial completo para Mac com Apple Silicon e Intel


## 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:

```bash
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:

```bash
/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:

```bash
brew --version
```

### Instalando Python com Homebrew

```bash
brew install python
```

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

```bash
python3 --version
pip3 --version
```

### Atualizando Python com Homebrew

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

```bash
brew upgrade python
```

### Instalando uma versão específica

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

```bash
brew install python@3.12
```

Para usar essa versão:

```bash
/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](https://www.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

```bash
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:

```bash
/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

```bash
brew install pyenv
```

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

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

Recarregue o terminal:

```bash
source ~/.zshrc
```

### Instalando dependências de compilação

```bash
brew install openssl readline sqlite3 xz zlib tcl-tk
```

### Usando o pyenv

Instalar uma versão:

```bash
pyenv install 3.13.1
```

Definir como versão global:

```bash
pyenv global 3.13.1
```

Verificar:

```bash
python --version
```

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

Definir versão por projeto:

```bash
cd meu-projeto
pyenv local 3.12.5
```

## Criando ambientes virtuais

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

```bash
python3 -m venv meu_projeto
source meu_projeto/bin/activate
```

Com o ambiente ativo, instale pacotes:

```bash
pip install django requests
```

Para desativar:

```bash
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:

```bash
xcode-select --install
```

### Alias útil

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

```bash
alias python="python3"
alias pip="pip3"
```

## Solução de problemas

### "xcrun: error: invalid active developer path"

Instale as Xcode Command Line Tools:

```bash
xcode-select --install
```

### Conflito entre versões

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

```bash
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`:

```bash
pip3 install --user nome-do-pacote
```

## Próximos passos

Com o Python instalado no seu Mac, recomendamos configurar o [VS Code para Python](/guias/configurando-vscode-para-python/) como ambiente de desenvolvimento.

Se você desenvolve no macOS, considere também instalar <a href="https://golang.com.br/blog/" target="_blank" rel="noopener" onclick="umami.track('portfolio-site-click', {source: 'python.dev.br', target: 'golang.com.br', content: 'instalando-python-mac'})">Go</a> e <a href="https://rustlang.com.br/blog/" target="_blank" rel="noopener" onclick="umami.track('portfolio-site-click', {source: 'python.dev.br', target: 'rustlang.com.br', content: 'instalando-python-mac'})">Rust</a> — ambos funcionam excelentemente no macOS e complementam seu toolkit de desenvolvimento.