Nenhum conhecimento prévio necessário

Nunca programou? Comece aqui.

Você vai entender o papel de cada ferramenta, instalar somente o necessário e executar um programa pequeno. Cada clique e comando importante aparece abaixo.

Antes de instalar

O que é cada coisa?

Esses nomes aparecem durante o curso. Leia as definições antes de seguir.

Programa
Um conjunto de instruções que o computador executa para realizar uma tarefa.
Python
A linguagem em que escreveremos as instruções e também o programa interpretador que consegue executá-las.
VS Code
O editor de código: o aplicativo no qual você cria, lê e salva seus arquivos. Ele não substitui o Python.
Terminal
Uma janela na qual digitamos comandos para pedir ao sistema operacional que abra ou execute algo.
Arquivo .py
Um arquivo de texto que contém instruções escritas em Python. O final .py identifica o tipo do arquivo.
Pasta do projeto
O local que reúne os arquivos relacionados ao programa. Saber qual pasta está aberta evita executar o arquivo errado.

Windows 10 ou 11

Instale as ferramentas

Use somente os endereços oficiais abaixo. Não é necessário comprar licença nem criar conta.

1

Interpretador

Instalar Python

O Python lê o arquivo .py e executa suas instruções.

  1. Abra o botão “Baixar Python” abaixo.
  2. Baixe o Python Install Manager oferecido para Windows.
  3. Abra o arquivo baixado e escolha Install.
  4. Feche e abra novamente o PowerShell ou o terminal do VS Code.
  5. Digite python --version e pressione Enter.

Resultado esperado: uma linha iniciada por Python 3. Na primeira execução, o gerenciador pode pedir autorização para instalar a versão estável.

2

Editor de código

Instalar VS Code

O Visual Studio Code é o aplicativo em que escreveremos e organizaremos os arquivos.

  1. Abra “Baixar VS Code”.
  2. Escolha o instalador User Setup para Windows.
  3. Execute o arquivo VSCodeUserSetup baixado.
  4. Aceite os termos, mantenha a pasta sugerida e avance até Instalar.
  5. Marque a opção para abrir o VS Code ao terminar.

Resultado esperado: a tela inicial do VS Code aparece e o menu Arquivo está disponível.

3

Ajuda dentro do editor

Instalar a extensão Python

A extensão da Microsoft ajuda o VS Code a reconhecer arquivos Python, selecionar o interpretador e executar o programa.

  1. No VS Code, clique no ícone Extensões na barra esquerda.
  2. Pesquise exatamente por Python.
  3. Escolha a extensão publicada pela Microsoft.
  4. Clique em Instalar e aguarde a conclusão.
  5. Se aparecer “Select Interpreter”, escolha uma versão iniciada por Python 3.

Resultado esperado: a página da extensão mostra o estado Instalada.

Faça junto

Crie e execute seu primeiro arquivo

Não pule passos. Depois de cada etapa, confira o resultado descrito.

  1. 1

    Crie a pasta do estudo

    Abra o Explorador de Arquivos do Windows, entre em Documentos, clique com o botão direito em uma área vazia e escolha Novo → Pasta. Dê o nome estudos-python.

  2. 2

    Abra a pasta no VS Code

    No VS Code, escolha Arquivo → Abrir Pasta, selecione Documentos\estudos-python e confirme em Selecionar Pasta. O nome da pasta deve aparecer na lateral esquerda.

  3. 3

    Crie o arquivo

    Na lateral esquerda, clique no botão Novo Arquivo. Digite primeiro_programa.py e pressione Enter. Confira que o nome termina em .py, não em .txt.

  4. 4

    Escreva duas instruções

    Copie o exemplo exatamente como aparece. A primeira linha pede um nome; a segunda mostra uma mensagem.

    nome = input("Qual é o seu nome? ")
    print(f"Olá, {nome}! Seu ambiente está funcionando.")
  5. 5

    Salve

    Pressione Ctrl + S. O pequeno círculo ao lado do nome da aba deve desaparecer, indicando que o conteúdo foi gravado no arquivo.

  6. 6

    Abra o terminal correto

    No menu superior, escolha Terminal → Novo Terminal. Uma área será aberta na parte inferior. Antes do cursor, o caminho deve terminar em estudos-python.

  7. 7

    Execute

    Digite o comando abaixo e pressione Enter. Se python não funcionar mas py funcionar, use py primeiro_programa.py.

    python primeiro_programa.py
  8. 8

    Confira o resultado

    O terminal perguntará seu nome. Digite-o e pressione Enter. Você deverá ver algo semelhante a: Olá, Ana! Seu ambiente está funcionando.

Se algo não funcionar

Erros iniciais comuns

“python não é reconhecido”
Feche e abra o terminal depois da instalação. Tente py --version. Se ambos falharem, consulte os aliases de execução indicados na documentação oficial do Python para Windows.
“can't open file”
O terminal está em outra pasta ou o nome foi digitado diferente. Confira se o caminho termina em estudos-python e se o arquivo se chama primeiro_programa.py.
O arquivo termina em .py.txt
Renomeie pelo VS Code para deixar somente .py. O final do nome informa ao editor e ao sistema qual é o tipo do arquivo.
SyntaxError
Compare o código com o exemplo, principalmente aspas e parênteses. Leia a última linha da mensagem; ela informa o tipo do problema e costuma apontar a linha aproximada.

Preparação concluída

Agora as primeiras aulas farão sentido.

Comece pela ES01 para compreender o que existe além do código. Depois, a PY01 retoma esse ambiente e constrói o primeiro programa acadêmico com calma.

Usa macOS ou Linux? Consulte as opções do site oficial do Python e do VS Code. Nesses sistemas, o comando pode ser python3.