Primeiro, um pouco de realidade
Você não precisa instalar nada para escrever suas primeiras linhas de Python. Os editores embutidos nestes docs rodam código Python de verdade no seu navegador, e dá para ir longe só com isso. Instalar o Python localmente é o momento em que você quer salvar arquivos na sua máquina, rodar programas mais longos ou usar bibliotecas que não vêm embutidas.
Se preferir pular direto para escrever código, vá para a próxima página. Se estiver pronto para instalar, segue o fio.
Verifique se o Python já está aí
Antes de instalar qualquer coisa, confira o que você já tem. Abra um terminal — Prompt de Comando ou PowerShell no Windows, Terminal no macOS, o shell que você usa no Linux — e digite:
python --version
Se aparecer "command not found", tente python3 --version. No macOS e na maioria das distros Linux você provavelmente vai ver algo como Python 3.12.6 já aí. Se o número começar com 3., está tranquilo.
Se aparecer Python 2. alguma coisa, trate como se o Python não estivesse instalado. O Python 2 chegou ao fim da vida em 2020 e não deve ser usado para código novo.
Instalando no Windows
- Vá para python.org/downloads.
- Clique no botão amarelo grande "Download Python 3.x.x". Ele detecta o Windows automaticamente.
- Abra o instalador. Antes de clicar em Install Now, marque a caixa "Add python.exe to PATH" no rodapé da janela. Esse é o passo mais importante de todos — sem ele,
pythonnão vai funcionar no seu terminal. - Clique em "Install Now" e espere um minuto. O instalador cuida do resto.
- Abra uma nova janela de PowerShell ou Prompt de Comando (as antigas não vão ter o PATH atualizado) e rode
python --version. Você deve ver a versão que acabou de instalar.
Se esqueceu de marcar a caixa do PATH, a solução mais fácil é rodar o instalador de novo, clicar em "Modify" e adicionar depois.
Instalando no macOS
Você tem duas opções boas. Escolha uma; não misture.
Opção A: o instalador do python.org. Baixe em python.org/downloads, abra o arquivo .pkg e siga os prompts. Ao terminar, python3 e pip3 ficam disponíveis no seu terminal.
Opção B: Homebrew. Se você já usa Homebrew para outras ferramentas:
brew install python
O Homebrew mantém o Python atualizado quando você roda brew upgrade, e é por isso que muitos desenvolvedores preferem essa rota. Seja qual for o caminho, confirme a instalação:
python3 --version
No macOS, sempre prefira python3 e pip3 em vez de python e pip sem o 3. Os comandos sem número às vezes apontam para um Python antigo do sistema que você não deve tocar.
Instalando no Linux
A maioria das distros já vem com Python 3. Rode python3 --version primeiro para conferir. Se precisar instalar ou atualizar, use seu gerenciador de pacotes:
- Debian / Ubuntu:
sudo apt update && sudo apt install python3 python3-pip python3-venv - Fedora:
sudo dnf install python3 python3-pip - Arch:
sudo pacman -S python python-pip
Vale pegar o pacote python3-venv (ou equivalente da sua distro) desde já — você vai usar ambientes virtuais assim que começar a instalar bibliotecas.
Verificando a instalação com código de verdade
Assim que o terminal mostrar um número de versão razoável, rode um programinha de ponta a ponta. No seu terminal:
python3
Isso te coloca no modo interativo do Python — um prompt que parece >>>. Digite uma linha e aperte enter:
>>> print("installed")
installed
>>> 2 + 2
4
>>> exit()
Se aparecer a saída em vez de um erro, terminou. Dá para sair da sessão interativa com exit() ou Ctrl-D.
E se você só quiser testar sem mexer no seu terminal, aqui vai um snippet executável que faz exatamente o mesmo que as linhas acima:
Quando algo dá errado
pythonabre a Microsoft Store no Windows. Isso acontece quando você pulou o passo "Add to PATH" e o Windows está tentando ajudar. Rode o instalador de novo, clique em Modify e adicione o Python ao PATH.pipnão encontrado. No macOS e Linux, tentepip3. No Windows,pipdeve funcionar se o Python estiver no PATH; caso contrário, usepython -m pip ...como alternativa confiável.- Várias versões do Python confundem você. Isso é normal, e gerenciá-las é exatamente para isso que existem os ambientes virtuais. Cobrimos eles num capítulo mais adiante.
Você está pronto
Com um comando python3 funcionando e um número de versão com que dá para conviver, você está pronto para o próximo passo: rodar de verdade um script que você escreveu. Isso vem a seguir.
Perguntas frequentes
Como faço para instalar o Python?
Baixe o instalador em python.org, execute e — no Windows — marque a caixa 'Add Python to PATH' antes de clicar em Install. No macOS e no Linux, o Python geralmente já está disponível; normalmente você só precisa instalar uma versão mais nova ao lado da versão do sistema.
Como verifico a versão do meu Python?
Abra um terminal e rode python --version ou python3 --version. Se aparecer um número como 3.12.2, o Python já está instalado. Se aparecer um erro de comando não encontrado, ainda falta instalar.
Preciso instalar o Python para aprender?
Não. Você pode rodar Python direto no navegador em sites como o Coddy, inclusive nos editores interativos destes docs. Instalar localmente é útil quando você quiser salvar projetos, trabalhar com arquivos no seu computador ou usar bibliotecas — mas não é pré-requisito para as primeiras lições.
Qual versão do Python devo instalar?
A versão estável atual do Python 3 — o python.org destaca ela na página inicial. Qualquer Python 3 recente está bom para aprender; você não precisa bater uma versão minor específica. Evite o Python 2 — foi aposentado há anos e não recebe mais atualizações de segurança.
