Instalando o Python no macOS, Windows e Linux

Qual versão instalar

Instale a série estável mais recente, que quando escrevi era a 3.14, e nunca baixe nada abaixo da 3.12 para um projeto novo. O Python 3.10 sai de suporte em outubro de 2026.

Uma regra que me poupa dor de cabeça: o Python que veio com o sistema é do sistema. Ele serve ao macOS ou à sua distribuição Linux, que dependem de uma versão específica. Para os seus projetos, instale um Python à parte.

Instalar por sistema operacional

brew install python
python3 --version

Erro externally-managed-environment

Em distribuições Linux recentes e no Homebrew, rodar pip install fora de um ambiente virtual falha com a mensagem externally-managed-environment. Isso é de propósito (a regra se chama PEP 668) e protege o Python do sistema. A solução correta é criar um ambiente virtual, que é o assunto do capítulo 4. Não use --break-system-packages.

Conferir a instalação

Antes de qualquer coisa, confirme a versão no terminal. Use python3 --version no macOS e no Linux, e py --version no Windows. Depois, rode este script, que mostra de onde o seu Python vem:

import platform
import sys

print("Versão:", platform.python_version())
print("Implementação:", platform.python_implementation())
print("Executável:", sys.executable)
print("Sistema:", platform.system())

Versão: 3.14.6
Implementação: CPython
Executável: /opt/homebrew/bin/python3
Sistema: Darwin

O bloco acima é um exemplo de um Mac com Homebrew. A sua saída vai variar, e é isso mesmo que você quer observar: o caminho do executável diz qual Python você está usando de fato.

Os comandos python, python3 e py

O modo interativo (REPL)

Digitar python3 (ou py) sem argumentos abre o modo interativo, ótimo para testar uma expressão rápida:

>>> 2 + 2
4
>>> "python".upper()
'PYTHON'
>>> exit()