Módulo 2 - Preparando o seu ambiente

Conferindo a instalação: python --version e o modo interativo

10 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 01/07/2026

O que você vai aprender

  • Abrir o Prompt de Comando ou o PowerShell sem procurar em menus.
  • Conferir a instalação com python --version e py --version.
  • Diagnosticar e resolver o erro de comando não reconhecido.
  • Entrar no modo interativo, executar uma conta e sair com exit().

Abrindo o terminal do Windows

Terminal é a tela de texto onde você conversa com o computador por comandos digitados, sem mouse e sem botões. O Windows tem dois principais: o Prompt de Comando, o veterano de fundo preto, e o PowerShell, o mais moderno, de fundo azul escuro. Para este curso, os dois servem igualmente, e nas versões recentes do Windows ambos abrem dentro de um aplicativo chamado Terminal do Windows. Use o que aparecer primeiro.

O jeito mais rápido de abrir: aperte a tecla Windows, digite cmd e pressione Enter. Uma janela abre mostrando algo como C:\Users\SeuNome> seguido de um cursor piscando. Esse texto é o prompt, e o cursor piscando é o terminal dizendo estou pronto, pode mandar. Pode parecer árido na primeira vez, mas em duas aulas essa tela vai ser território conhecido. Todo programador profissional passa parte do dia numa janela igual a essa.

Os dois comandos de conferência

Com o terminal aberto, digite o comando abaixo e pressione Enter. Repare que são dois hífens antes de version, colados na palavra.

python --version

Pergunta ao Python instalado qual é a versão dele.

C:\Users\SeuNome> python --version
Python 3.12.4

Resposta esperada. O número exato pode variar; o que importa é começar com 3 e ser recente.

Se apareceu Python 3 e um número de versão, a instalação está perfeita. Confira também o launcher, digitando py --version: a resposta deve ser a mesma. O py é um atalho do Windows que sabe encontrar o Python instalado, e é útil guardar que ele existe, porque em computadores com configuração fora do padrão ele funciona mesmo quando o comando python falha.

E se em vez da versão aparecer a mensagem abaixo? Calma, é o problema mais comum e mais bem mapeado do mundo Python no Windows.

'python' não é reconhecido como um comando interno
ou externo, um programa operável ou um arquivo em lotes.

O aviso clássico de PATH: o Windows não sabe em que pasta procurar o Python.

Essa mensagem quase sempre significa que a caixinha Add python.exe to PATH ficou desmarcada na instalação. O roteiro de conserto, em ordem: primeiro, feche e abra o terminal de novo, porque um terminal aberto antes da instalação não enxerga o PATH atualizado. Segundo, teste py --version; se funcionar, você já pode seguir o curso usando py no lugar de python enquanto não arruma o resto. Terceiro, o conserto definitivo: rode o instalador de novo, escolha Modify, marque Add Python to environment variables em Advanced Options e conclua. Há ainda uma pegadinha do Windows: se ao digitar python abrir a Microsoft Store, procure por Aliases de execução de aplicativo nas configurações do sistema e desligue os dois itens de nome Python.

O modo interativo: conversando com o Python

Agora o momento divertido da aula. No terminal, digite apenas python (ou py) e pressione Enter, sem nada depois. Em vez de executar e devolver o prompt do Windows, o Python assume a conversa: mostra a versão, uma mensagem de boas-vindas e um prompt novo, formado por três sinais de maior. Você entrou no modo interativo, o REPL, onde cada linha digitada é executada na hora.

C:\Users\SeuNome> python
Python 3.12.4 (tags/v3.12.4) [MSC v.1940 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> 2 + 3
5
>>> print("O Python está vivo!")
O Python está vivo!
>>> exit()

C:\Users\SeuNome>

Uma sessão completa no modo interativo: entrar, calcular, imprimir e sair com exit().

Experimente: digite 2 + 3 e Enter. O Python responde 5 na linha seguinte, sem cerimônia. Digite um print, como no módulo 1, e a frase aparece na hora. O REPL é a calculadora e o rascunho do programador: perfeito para testar uma linha, conferir uma conta ou tirar uma dúvida rápida. Não é onde se escrevem programas de verdade, porque tudo evapora quando a janela fecha, mas como bancada de testes ele acompanha você a trilha inteira.

Para sair, digite exit() com os parênteses e pressione Enter: o prompt do Windows volta, sinal de que a conversa com o Python terminou. Guarde essa distinção visual desde já, porque ela evita metade das confusões do iniciante: prompt com >>> é o Python esperando código; prompt com C:\...> é o Windows esperando comandos. A aula 5 deste módulo aprofunda exatamente isso.

Teste rápido

Você digitou python --version e o terminal respondeu que o comando não é reconhecido. Qual é a causa mais provável?

Perguntas frequentes

Qual a diferença entre os comandos python e py?
O python chama o interpretador direto e depende de a pasta dele estar no PATH. O py é um launcher do Windows, instalado junto, que localiza a versão instalada sozinho. Na prática do curso são intercambiáveis: onde a aula disser python, o py faz o mesmo serviço.
Digitei python e abriu a loja da Microsoft. E agora?
É um atalho do próprio Windows para quem não tem Python instalado. Se você já instalou do site oficial, desative o atalho: procure Aliases de execução de aplicativo nas configurações do Windows e desligue as duas entradas de nome Python. Alternativa imediata: use o comando py, que ignora esse atalho.
Prompt de Comando ou PowerShell: qual devo usar?
Tanto faz para este curso: os comandos python, py e a execução de arquivos funcionam igual nos dois. O PowerShell é mais moderno e é o padrão do Terminal do Windows atual. Escolha um, acostume-se com ele e siga em frente.
Meu python --version mostra uma versão diferente da aula. Tem problema?
Se começar com 3.12 ou número maior, nenhum. O curso usa recursos estáveis da linguagem, presentes em qualquer versão 3 recente. Só volte à aula anterior e atualize se a versão for 3.9 ou mais antiga, ou se por acaso começar com 2.
Fechei o terminal com o modo interativo aberto. Estraguei algo?
Não. Fechar a janela encerra o Python na hora, sem dano nenhum ao sistema. Você só perde o que tinha digitado naquela sessão do REPL, que é descartável por natureza. O jeito educado de sair continua sendo exit(), mas o botão de fechar não é crime.
O que exatamente o exit() faz? Por que os parênteses?
O exit() é uma função que encerra a sessão do modo interativo e devolve o controle ao terminal do Windows. Os parênteses são a forma de executar uma função em Python, coisa que o módulo 13 explica a fundo. Sem eles, o Python apenas descreve a função em vez de executá-la e dá a dica de digitar com parênteses.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.