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.
Não pule passos. Depois de cada etapa, confira o resultado descrito.
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
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
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
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
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
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
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
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.