Instalar o Python no Windows e no Linux: guia passo a passo

Como instalar corretamente o Python no Windows, com o novo Python Install Manager, e no Linux, e como verificar que tudo funciona.

Instalar o Python no Windows e no Linux: guia passo a passo

O Python é uma das linguagens de programação mais usadas do mundo: serve para escrever scripts que automatizam tarefas repetitivas, analisar dados, criar aplicações web e ligar diferentes serviços através de API. Antes de escrever a primeira linha de código, porém, é preciso instalá-lo da forma correta.

Nos últimos meses o procedimento no Windows mudou: o clássico instalador descarregado de python.org está a dar lugar ao novo Python Install Manager. Muitos guias disponíveis online ainda descrevem o método antigo. Neste artigo vemos como instalar hoje o Python no Windows e no Linux, que versão escolher e como resolver os problemas mais frequentes.

Que versão do Python escolher

O Python lança uma nova versão principal todos os anos. A mais recente, Python 3.15, foi publicada a 9 de outubro de 2026. Quando sai uma versão nova, no entanto, nem todas as bibliotecas ficam prontas de imediato: algumas demoram semanas ou meses a publicar pacotes compatíveis.

Por isso, um conselho prático:

  • Para aprender e fazer experiências, a versão mais recente é perfeita.
  • Para projetos que usam muitas bibliotecas externas, convém usar a versão anterior, hoje a 3.14, até que as bibliotecas de que precisa suportem a nova.

Como veremos, com o novo Install Manager pode ter várias versões instaladas ao mesmo tempo e escolher qual usar em cada projeto.

Instalar o Python no Windows com o Python Install Manager

O Python Install Manager é a ferramenta oficial da equipa do Python para instalar e gerir o Python no Windows. Não é o Python em si: é um pequeno programa que descarrega, atualiza e remove as versões do Python de que precisa. O instalador tradicional deixará de ser publicado a partir do Python 3.16, por isso este é o método a aprender.

Funciona no Windows 10, Windows 11 e Windows Server 2022 ou posterior.

Passo 1: instalar o Install Manager

Tem três possibilidades, totalmente equivalentes:

  • Microsoft Store: procure «Python Install Manager» e clique em Instalar. É o método recomendado para a maioria dos utilizadores, porque as atualizações chegam automaticamente.
  • Site oficial: descarregue o pacote da página de transferências de python.org e abra-o com um duplo clique.
  • Linha de comandos: se usa o WinGet, abra a Linha de Comandos e escreva:
winget install 9NQ7512CXL7T

Se no computador já estava instalada uma versão do Python com o método antigo, é aconselhável desinstalar o antigo «Python Launcher» em Definições → Aplicações, porque também usa o comando py e os dois podem entrar em conflito. As versões do Python já instaladas, pelo contrário, podem ficar.

Passo 2: a configuração inicial

Abra a Linha de Comandos (procure «cmd» no menu Iniciar) ou o Terminal e escreva:

py install --configure

Arranca uma verificação guiada da configuração do sistema. Provavelmente ser-lhe-á pedido que adicione uma pasta à variável PATH: responda que sim. O PATH é a lista de pastas onde o Windows procura os programas quando escreve um comando; sem este passo, alguns comandos não seriam encontrados.

Passo 3: instalar uma versão do Python

Para instalar uma versão, indique o seu número. Por exemplo, para a versão mais recente e para a anterior:

py install 3.15
py install 3.14

Pode repetir o comando com versões diferentes: ficarão todas disponíveis. Para ver que versões tem instaladas e qual é a predefinida:

py list

Para ver que versões pode instalar:

py list --online

Passo 4: executar o Python

Depois da instalação tem três comandos à disposição:

  • python inicia a versão predefinida, normalmente a mais recente que instalou.
  • py faz o mesmo, mas também permite escolher a versão com a opção -V:, por exemplo py -V:3.14.
  • pymanager serve para gerir as instalações. É útil sobretudo se o antigo launcher ainda estiver no computador e o comando py estiver «ocupado».

Por exemplo, para executar um script com uma versão específica:

py -V:3.14 meu_script.py

Para a ajuda completa dos comandos existe sempre py help e, para os detalhes de um único comando, por exemplo py help install.

Atualizar e desinstalar

O Install Manager atualiza-se sozinho no prazo de um dia após o lançamento de uma nova versão. As versões do Python instaladas, por outro lado, gerem-se com os comandos py install e py uninstall, por exemplo:

py uninstall 3.13

Desinstalar o Install Manager não remove as versões do Python já instaladas. Para uma limpeza completa existe o comando py uninstall --purge.

Instalar o Python no Linux

No Linux a situação é diferente: quase todas as distribuições já trazem o Python instalado, porque muitas ferramentas do sistema o usam. Para verificar, abra o terminal e escreva:

python3 --version

No Linux o comando chama-se normalmente python3, e não python.

Ubuntu e Debian

Mesmo que o Python esteja presente, faltam muitas vezes dois componentes indispensáveis: o pip, o programa que instala as bibliotecas, e o módulo venv, que serve para criar ambientes virtuais. Instale-os assim:

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

Fedora, Rocky Linux, AlmaLinux

sudo dnf install python3 python3-pip

Nestas distribuições o módulo venv já está incluído no pacote principal.

Uma regra importante no Linux

Não remova nem substitua o Python do sistema, nem sequer para ter uma versão mais recente: partes do sistema operativo dependem dele e poderia torná-lo instável. Da mesma forma, evite instalar bibliotecas com sudo pip install. As distribuições mais recentes impedem-no com o erro externally-managed-environment, precisamente para proteger o sistema.

A solução correta é trabalhar sempre dentro de um ambiente virtual, um tema a que dedicamos um artigo nesta mesma categoria.

Verificar que tudo funciona

Vamos fazer um teste completo. Crie um ficheiro de texto chamado ola.py com este conteúdo:

import sys

print("O Python funciona!")
print("Versão em uso:", sys.version)

Depois, a partir da pasta onde guardou o ficheiro, execute-o:

# Windows
python ola.py

# Linux
python3 ola.py

Se aparecerem a mensagem e o número da versão, o Python está corretamente instalado.

Problemas comuns no Windows

  • Ao escrever python abre-se a Microsoft Store. É um atalho do Windows chamado «alias de execução de aplicações». Vá a Definições → Aplicações → Definições avançadas de aplicações → Aliases de execução de aplicações e desative as entradas «python.exe» e «python3.exe» que apontam para o instalador da Store. Em alternativa, use simplesmente o comando py.
  • «py» não é reconhecido como comando. Feche e volte a abrir o terminal: as alterações ao PATH só valem para as janelas abertas depois da instalação. Se o problema persistir, volte a executar pymanager install --configure.
  • O comando py inicia uma versão antiga. O antigo Python Launcher ainda está ativo: desinstale-o em Definições → Aplicações ou use o comando pymanager.
  • Erros ao instalar bibliotecas com o pip, como «Microsoft Visual C++ 14.0 or greater is required». Costumam dever-se a uma versão do Python demasiado recente: falamos disso num artigo dedicado.

Próximos passos

Com o Python instalado, está pronto para começar. O passo seguinte recomendado é aprender a usar os ambientes virtuais: permitem instalar as bibliotecas de cada projeto separadamente, sem conflitos e sem mexer no sistema. É o hábito que distingue quem programa em Python sem problemas de quem passa horas a perseguir erros de instalação.

Fontes oficiais

Partilhar

Qual é a sua reação?

Gosto Gosto 0
Não gosto Não gosto 0
Adoro Adoro 0
Divertido Divertido 0
Irritado Irritado 0
Triste Triste 0
Uau Uau 0