Módulo 2 - Preparando o seu ambiente

Prática: sua pasta de projetos e o primeiro .py executado

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

O que você vai aprender

  • Criar a pasta de projetos do curso pelo terminal, com mkdir e cd.
  • Escrever e salvar o ola.py dentro da pasta, usando o VS Code.
  • Executar o programa pelo terminal com o comando python ola.py.
  • Conferir o checklist final e declarar o ambiente pronto.

Criando a casa dos seus projetos

Todo programador tem um canto do disco onde os projetos moram. Sem isso, os arquivos se espalham entre Downloads, Documentos e área de trabalho, e em duas semanas ninguém mais acha o exercício do módulo 5. A prática de hoje cria esse canto: uma pasta chamada meus-projetos-python, direto na raiz do disco C:, onde vai morar tudo o que você escrever no curso. E de propósito, vamos criá-la pelo terminal, para treinar os comandos da aula anterior.

mkdir C:\meus-projetos-python
cd C:\meus-projetos-python

mkdir cria a pasta (make directory); cd entra nela. Rode uma linha de cada vez, com Enter no fim.

Depois do cd, repare no prompt: ele agora mostra C:\meus-projetos-python>, confirmando que o terminal está dentro da pasta nova. Esse detalhe importa mais do que parece. O terminal sempre trabalha a partir de uma pasta, o diretório de trabalho, e o comando de executar um arquivo procura esse arquivo ali. Executar python ola.py com o terminal posicionado na pasta errada é a causa número um do erro can't open file, que veremos daqui a pouco.

Escrevendo o ola.py e executando pelo terminal

Agora o arquivo. Abra o VS Code e use Arquivo, Abrir Pasta para abrir a C:\meus-projetos-python; ela estará vazia, como esperado. No explorador da esquerda, crie um arquivo novo chamado ola.py e digite dentro dele as duas linhas abaixo. Digite, não cole: dedo que digita é dedo que aprende.

print("Olá! Este programa roda do meu computador.")
print("Ambiente pronto: Python, VS Code e terminal funcionando.")

O conteúdo do ola.py. Duas linhas, dois prints, e não esqueça o Ctrl+S para salvar.

Salve com Ctrl+S e vá para o terminal. Pode ser o terminal integrado do VS Code (menu Terminal, Novo Terminal), que já abre dentro da pasta, ou o terminal do Windows da aula 3, desde que você navegue até a pasta com cd C:\meus-projetos-python. Nele, digite o comando que junta tudo o que este módulo ensinou:

C:\meus-projetos-python> python ola.py
Olá! Este programa roda do meu computador.
Ambiente pronto: Python, VS Code e terminal funcionando.

O momento da verdade: o interpretador lê o seu arquivo e executa as duas linhas, na ordem.

Se as duas frases apareceram, registre o marco: você escreveu um programa num arquivo seu, numa pasta sua, e o executou pelo terminal, exatamente como programadores profissionais fazem todos os dias. Se em vez disso apareceu um erro parecido com can't open file ou No such file or directory, o diagnóstico é quase sempre um destes dois: o terminal está em outra pasta (confira o prompt e use cd) ou o nome digitado não bate com o do arquivo (olá.py com acento e ola.py sem acento são arquivos diferentes). Corrigiu, rodou, seguiu.

Checklist final: ambiente pronto

Fim de módulo pede conferência. A lista abaixo resume tudo o que ficou de pé nestas seis aulas. Marque mentalmente cada item; qualquer um que falhe tem a aula correspondente indicada para revisão rápida.

  1. Sei abrir o Playground do curso e sei que ele cobre todas as aulas (aula 1).
  2. O Python 3.12 ou mais novo está instalado, baixado do python.org (aula 2).
  3. python --version e py --version respondem com a versão no terminal (aula 3).
  4. Sei entrar no modo interativo e sair com exit() (aula 3).
  5. O VS Code está instalado com a extensão Python da Microsoft (aula 4).
  6. Sei diferenciar terminal, editor e arquivo .py, e interativo de script (aula 5).
  7. A pasta C:\meus-projetos-python existe e o ola.py rodou nela com python ola.py (aula 6).

Sete itens conferidos, ambiente declarado pronto. Se você seguiu só pelo Playground, a sua versão do checklist é mais curta: itens 1, 6 e a prática desta aula feita no laboratório, trocando o terminal pelo botão Executar. Dos dois jeitos, a fase de arrumar a oficina terminou. O módulo 3 volta a atenção para onde ela deve ficar até o fim do curso: o código. O print vai ganhar profundidade, os erros de sintaxe vão perder o mistério e o seu primeiro programa completo sai do forno.

Teste rápido

Ao rodar python ola.py, o terminal respondeu can't open file. O arquivo existe e está salvo em C:\meus-projetos-python. Qual é a causa mais provável?

Perguntas frequentes

Preciso criar a pasta exatamente em C:\meus-projetos-python?
Não, o local e o nome são sugestões para o curso falar a mesma língua que você. Pode ser dentro de Documentos ou em outro disco, desde que o nome não tenha espaço nem acento e que você saiba navegar até lá com cd. O importante é ter UM lugar fixo para tudo do curso.
Qual a diferença entre criar a pasta pelo terminal e pelo Explorador de Arquivos?
Nenhuma no resultado: a pasta criada com mkdir é idêntica à criada com o botão direito no Explorador. A prática usa o terminal para você treinar mkdir e cd, comandos que aparecem o tempo todo na vida de quem programa. Use o caminho que preferir no dia a dia.
Posso dar outro nome ao arquivo, em vez de ola.py?
Pode, seguindo as regras de ouro: termine em .py, evite espaço e acento, e use letras minúsculas com hífen ou traço baixo entre palavras, como meu-primeiro-programa.py. Lembre de usar o mesmo nome no comando: python meu-primeiro-programa.py.
Dois prints no arquivo: por que as frases saem nessa ordem?
Porque um script roda de cima para baixo, linha por linha, na ordem em que está escrito. O primeiro print executa, depois o segundo. Essa leitura sequencial é a base de tudo o que vem nos próximos módulos, incluindo os desvios com if e as repetições com while e for.
O ola.py rodou pelo play do VS Code, mas falha no terminal de fora. Por quê?
Quase sempre é o diretório de trabalho: o terminal integrado do VS Code já abre dentro da pasta do projeto, e o terminal avulso abre na sua pasta de usuário. Digite cd C:\meus-projetos-python no terminal de fora e rode de novo. Se o erro for de comando não reconhecido, revisite a aula 3, que trata do PATH.
Fiz tudo pelo Playground. O que muda desta prática para mim?
A essência fica: digite as duas linhas do ola.py no laboratório e execute com o botão. O que o Playground não tem é a parte de pastas e terminal, que é específica do computador. Quando você tiver uma máquina disponível, volte a esta aula: com o restante do módulo lido, a prática completa leva menos de dez minutos.

Fontes

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