Curso de Python / Instalar Python no Windows e verificar o interpretador

No Windows, você pode instalar um interpretador com o Python Install Manager oficial e conferir a versão e o caminho do executável pelo PowerShell. Antes de mudar uma instalação existente, identifique os comandos em uso; depois, crie um ambiente separado para os exercícios do curso.

Confira os comandos que já existem no computador

Abra o PowerShell pelo menu Iniciar e execute cada linha separadamente. Se Python ainda não estiver instalado, ou se um dos nomes não estiver disponível, algumas linhas poderão mostrar uma mensagem de erro.

Get-Command python, py -ErrorAction SilentlyContinue
python --version
py --version

Get-Command informa como o PowerShell resolve um nome de comando. As linhas seguintes pedem a versão dos programas encontrados como python e py. Esses nomes podem apontar para ferramentas diferentes: py pode ser o Install Manager atual ou o iniciador antigo, chamado Python Launcher.

Não remova um Python incluído em outro aplicativo nem uma instalação administrada pela sua organização apenas porque ele apareceu na consulta. Registre o caminho e preserve os projetos que já funcionam. A preparação do curso deve usar uma pasta própria, em vez de alterar os arquivos ou os pacotes de outro aplicativo.

Instale pelo gerenciador oficial e selecione a versão

Consulte a página oficial de downloads de Python para Windows e a seção de instalação da documentação de Python no Windows. Verifique se o computador e as políticas da organização atendem aos requisitos indicados para o instalador escolhido.

  1. Escolha o Python Install Manager oferecido em python.org ou a entrada da Microsoft Store indicada pela documentação oficial. Confira a origem e o publicador antes de instalar.
  2. Se tiver baixado o arquivo MSIX, abra-o e siga a instalação. Se ela for bloqueada por uma política da organização, use o procedimento aprovado pelo administrador; não tente resolver isso desativando as proteções do computador.
  3. Feche o terminal antigo e abra um novo PowerShell. Execute os comandos abaixo para instalar a série 3.12 usada nos exemplos e conferir o interpretador selecionado.
py install 3.12
py -V:3.12 --version
py -V:3.12 -c "import sys; print(sys.executable)"

py install 3.12 instala uma versão da série 3.12; ele não promete fixar um número específico de atualização. A opção -V:3.12 seleciona essa série nas duas verificações. Espere uma saída de versão no formato Python 3.12.x e, na última linha, um caminho para o executável. O número da atualização e o caminho completo dependem da instalação.

Se py install falhar, veja qual ferramenta atende por py e consulte py --help. O Launcher antigo não oferece os mesmos subcomandos de gerenciamento. A documentação oficial explica os conflitos de comandos; não misture instruções de ferramentas diferentes nem suponha que a falha signifique que a versão deixou de existir. O gerenciador atual também oferece o comando pymanager, útil para distinguir essa ferramenta quando há um Launcher antigo.

Crie um ambiente exclusivo para o projeto

Escolha uma pasta de trabalho em que você tenha permissão de escrita. Os comandos abaixo criam a pasta python-lab, entram nela e usam o interpretador selecionado para criar .venv. Se já houver uma pasta com esses nomes, escolha outra pasta para este teste antes de repetir os comandos.

mkdir python-lab
cd python-lab
py -V:3.12 -m venv .venv
.\.venv\Scripts\python.exe --version
.\.venv\Scripts\python.exe -m pip --version

O módulo venv cria um ambiente com seu próprio interpretador e seus pacotes. A primeira verificação deve mostrar a série 3.12. A segunda deve informar a versão de pip e um caminho dentro de python-lab\.venv. Se o caminho apontar para outra instalação, confira a pasta atual e o executável usado no comando.

Chamar .\.venv\Scripts\python.exe diretamente dispensa a ativação do ambiente. Isso permite praticar sem modificar a política de execução do PowerShell quando um script de ativação está bloqueado. Salve o código-fonte ao lado de .venv, e não dentro dela. Ao mudar de computador, recrie o ambiente e reinstale as dependências, em vez de copiar a pasta inteira.

Verifique a execução e identifique falhas comuns

Ainda na pasta python-lab, use o executável do ambiente para calcular uma soma:

.\.venv\Scripts\python.exe -c "print(3500 + 8000 + 2500)"

A saída esperada é 14000. Esse resultado confirma que o interpretador escolhido consegue executar a expressão. Ele não confirma, sozinho, que um editor como VS Code selecionará o mesmo ambiente: no editor, confira também o caminho do interpretador.

  • O comando abre a Microsoft Store: verifique se Python está instalado e consulte os aliases de execução de aplicativo nas configurações do Windows. Compare o resultado de Get-Command com o caminho desejado.
  • O terminal ainda encontra uma instalação antiga: abra uma nova janela após mudanças de instalação ou de PATH, a lista de pastas usada para procurar executáveis. Confira py --help e py -c "import sys; print(sys.executable)" antes de mudar a seleção.
  • O caminho de .venv não é encontrado: confirme que o terminal está na pasta do projeto e que a criação do ambiente terminou sem erro.
  • pip instala em outro local: execute pip com o caminho explícito do interpretador, como no exemplo. Instalar tudo globalmente como administrador não corrige uma seleção errada de Python.

Antes de desinstalar um interpretador, identifique os projetos e ambientes que dependem dele. Preserve os arquivos de código e os registros de dependências separadamente: remover Python não equivale a apagar apenas um exercício, e remover um ambiente virtual pode exigir recriá-lo para continuar o projeto.