Curso de Python / Preparar Python no macOS e no Ubuntu

No macOS e no Ubuntu, comece conferindo a versão e o caminho de python3 e crie um ambiente virtual para o projeto. Mantenha o ambiente de desenvolvimento separado do Python usado pelo sistema operacional; substituir o executável do sistema pode prejudicar outras ferramentas.

Identifique o interpretador já disponível

Abra o aplicativo Terminal no macOS ou um terminal no Ubuntu. Execute estas linhas separadamente, sem acrescentar os caracteres de um prompt:

python3 --version
command -v python3
python3 -c "import sys; print(sys.executable)"

A primeira linha mostra a versão. command -v informa como o shell encontra python3, e sys.executable mostra o executável usado pelo processo Python. Os caminhos podem envolver links simbólicos; use essas informações para identificar a instalação, em vez de presumir que o nome do comando garante a versão desejada.

Os exemplos básicos do curso usam Python 3.12 ou posterior. Se o comando não existir ou a versão for anterior, siga apenas a instalação correspondente ao seu sistema. Não altere manualmente o link /usr/bin/python3 para apontar para outra versão. A documentação sobre Python em sistemas Unix explica que a distribuição e o método de instalação influenciam a localização do interpretador.

Use o instalador oficial no macOS

1. Acesse a página oficial de downloads de Python para macOS. Escolha uma versão compatível com a versão do macOS e o processador do computador, conferindo os requisitos e o Read Me do instalador.
2. Abra o pacote .pkg, leia as informações e siga o assistente. Depois de concluir a instalação, abra uma nova janela do Terminal.
3. Repita as três verificações anteriores. Se houver várias instalações, identifique o executável desejado antes de criar o ambiente virtual.

No instalador de python.org, confira também a etapa de certificados descrita na documentação oficial de instalação no macOS. O arquivo Install Certificates.command fica na pasta da versão instalada em /Applications. Execute a preparação conforme as instruções desse instalador. Ela não é uma etapa universal para todos os gerenciadores de Python.

Se uma requisição HTTPS falhar, identifique o Python em execução e a configuração de certificados usada por ele. Desativar a verificação de certificados impede que o programa autentique o servidor e não corrige a configuração de confiança. Preserve também qualquer instalação mantida pela Apple ou por ferramentas de desenvolvimento.

Instale os pacotes da distribuição no Ubuntu

Em uma instalação Ubuntu com acesso aos repositórios e permissão para usar sudo, atualize a lista de pacotes e instale o interpretador, o suporte a ambientes virtuais e pip. sudo pode pedir sua senha; o terminal normalmente não mostra caracteres enquanto você a digita.

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

Os nomes acima selecionam os pacotes da versão do Ubuntu, não uma versão fixa de Python. Confira a saída final. Se ela não atender ao mínimo do exercício, escolha uma versão Ubuntu compatível ou um ambiente de desenvolvimento separado, sem substituir o Python do sistema. O guia oficial de preparação de Python no Ubuntu também apresenta python3-full, um pacote que reúne o interpretador, a biblioteca completa e suporte a venv.

Se pip apresentar externally-managed-environment ao tentar instalar um pacote no Python do sistema, isso indica que esse ambiente é gerenciado externamente, por exemplo pelo gerenciador de pacotes da distribuição. Instale as dependências do projeto no ambiente virtual. Não use sudo pip nem uma opção para ignorar essa proteção como solução padrão.

Crie a pasta do projeto e verifique o ambiente

Depois de preparar o interpretador, escolha uma pasta de trabalho com permissão de escrita e execute o bloco abaixo. Se já houver uma pasta python-lab com seus arquivos, use outra pasta para o teste. O ambiente fica em .venv; o código do projeto deve ficar fora dela.

mkdir python-lab
cd python-lab
python3 -m venv .venv
.venv/bin/python --version
.venv/bin/python -m pip --version
.venv/bin/python -c "print(3500 + 8000 + 2500)"

A versão deve atender ao requisito do curso, a saída de pip deve apontar para o ambiente do projeto e o cálculo deve mostrar 14000. Os caminhos completos e o número da versão de pip variam conforme a instalação. Se você precisar escolher outro executável, substitua apenas python3 no comando que cria o ambiente pelo caminho do interpretador desejado.

Nos shells Bash ou Zsh, source .venv/bin/activate ativa o ambiente na sessão atual. Depois disso, python deve selecionar o ambiente; confira com python -c "import sys; print(sys.executable)". Use deactivate para sair. A ativação apenas facilita a seleção de comandos no shell; executar .venv/bin/python diretamente, como no exemplo, também funciona.

Se a criação falhar porque falta venv ou ensurepip, verifique o suporte correspondente ao interpretador escolhido. No Ubuntu, um Python instalado por outro método pode não usar o mesmo pacote venv da versão padrão da distribuição. Leia a mensagem completa e confira versão e caminho antes de repetir a instalação. Ao recriar .venv, preserve os scripts e os registros de dependências que ficam fora dela.