Pular para o conteúdo principal

Aula 02: Ambiente de Desenvolvimento — Python e VS Code

Duração: 2 horas Módulo: Fundamentos Ambiente sugerido: Python 3.14 ou superior · VS Code com extensão Python

Objetivos de Aprendizagem​

Ao final desta aula, você será capaz de:

  1. ✅ Instalar o Python 3.14 (ou superior) no seu sistema operacional (Windows, macOS ou Linux)
  2. ✅ Instalar e configurar o VS Code como ambiente de desenvolvimento, incluindo a extensão Python
  3. ✅ Utilizar o terminal integrado do VS Code para executar comandos básicos
  4. ✅ Criar e executar o seu primeiro script Python (Hello, World!) no VS Code
  5. ✅ Identificar e resolver os problemas mais comuns de instalação e configuração

Pré-requisitos e Verificação​

:::info Pré-requisito conceitual Esta aula pressupõe os conceitos da Aula 01: Introdução ao Pensamento Computacional — em especial a diferença entre algoritmo e programa. Não é necessário nenhum conhecimento técnico prévio sobre instalação de software ou uso de terminal. :::

Já tem Python ou VS Code instalados?​

Se você já possui Python ou VS Code no seu computador, verifique as versões antes de prosseguir. Talvez não seja necessário reinstalar.

Abra o Prompt de Comando (tecle Win + R, digite cmd e pressione Enter):

python --version
code --version
  • Python: se a versão for 3.10 ou superior, seu Python é compatível. Recomendamos 3.14 para acompanhar exatamente os exemplos.
  • VS Code: qualquer versão recente funciona. Se o comando code --version não for reconhecido, o VS Code não está instalado ou não está no PATH.

Se ambos estiverem instalados e atualizados, você pode ir direto para a seção Extensões Recomendadas.

Instalação do Python​

O Python é a linguagem de programação que usaremos ao longo de toda a disciplina. Vamos instalar a versão mais recente diretamente do site oficial.

:::note Conceito: PATH PATH é uma variável de ambiente do sistema operacional que contém a lista de pastas onde o sistema procura programas executáveis. Quando você digita python no terminal, o sistema percorre as pastas listadas no PATH até encontrar o programa. Se o Python não estiver no PATH, o terminal não vai reconhecer o comando. :::

Passo a passo no Windows​

  1. Acesse python.org/downloads e clique em "Download Python 3.14.x" (o botão principal da página)
  2. Execute o instalador baixado (python-3.14.x-amd64.exe)
  3. Marque a opção "Add python.exe to PATH" — essa é a etapa mais importante da instalação

:::danger Atenção Se você não marcar "Add python.exe to PATH", o comando python não será reconhecido no terminal. Se esquecer, veja a seção Problemas Comuns e Soluções. :::

  1. Clique em "Install Now" (instalação padrão)
  2. Aguarde a instalação e clique em "Close"

Verificação​

Abra o Prompt de Comando (Win + R → cmd → Enter) e digite:

python --version

Saída esperada:

Python 3.14.3

:::warning Evite a Microsoft Store O Windows pode sugerir abrir a Microsoft Store ao digitar python. Não instale o Python pela Microsoft Store — essa versão tem limitações de PATH e permissões. Use sempre o instalador do site oficial. :::

Instalação do VS Code​

O VS Code (Visual Studio Code) é o editor de código que usaremos nesta disciplina. Ele é gratuito, leve e possui excelente suporte para Python.

:::note Conceito: IDE IDE (Integrated Development Environment — Ambiente de Desenvolvimento Integrado) é um software que reúne editor de código, terminal, ferramentas de depuração e extensões em uma única janela. O VS Code é uma IDE leve e versátil, adequada tanto para iniciantes quanto para profissionais. :::

Passo a passo no Windows​

  1. Acesse code.visualstudio.com e clique em "Download for Windows"
  2. Execute o instalador baixado (.exe)
  3. Aceite a licença e avance com as opções padrão
  4. Na tela de tarefas adicionais, marque:
    • ✅ "Adicionar ação 'Abrir com Code' ao menu de contexto de arquivo"
    • ✅ "Adicionar ação 'Abrir com Code' ao menu de contexto de diretório"
    • ✅ "Adicionar ao PATH" (geralmente marcado por padrão)
  5. Clique em "Instalar" e, ao final, em "Concluir"

Verificação​

Abra o Prompt de Comando e digite:

code --version

Se exibir um número de versão, a instalação foi bem-sucedida.

Extensões Recomendadas​

:::note Conceito: Extensão Uma extensão (ou extension) é um complemento que adiciona funcionalidades ao VS Code. Extensões permitem que o editor reconheça linguagens de programação, formate código, destaque erros e muito mais. :::

Extensão obrigatória: Python​

A única extensão que você precisa instalar é a Python (da Microsoft):

  1. Abra o VS Code
  2. Clique no ícone de Extensões na barra lateral esquerda (ou pressione Ctrl+Shift+X / Cmd+Shift+X)
  3. Na barra de busca, digite "Python"
  4. Localize a extensão Python publicada pela Microsoft (identificador: ms-python.python)
  5. Clique em "Instalar"

Ao instalar a extensão Python, o VS Code instala automaticamente:

  • Pylance — servidor de linguagem que oferece autocompletar, verificação de tipos e navegação no código
  • Python Debugger — ferramenta para depurar (encontrar erros em) programas Python
  • Python Environments — gerenciador de ambientes Python

:::note Conceito: Interpretador O interpretador é o programa que lê e executa código Python linha a linha. Quando você instala o Python, está instalando o interpretador. O VS Code precisa saber qual interpretador usar — ele geralmente detecta automaticamente, mas se houver mais de um Python instalado, pode ser necessário selecionar manualmente (veja Problemas Comuns e Soluções). :::

Verificação​

Após a instalação, abra qualquer arquivo .py no VS Code. Você deve ver:

  • O nome do interpretador Python na barra de status inferior (ex.: Python 3.14.3)
  • Destaque de sintaxe colorido no código
  • Sugestões de autocompletar ao começar a digitar

Indo além (extensões opcionais)​

Estas extensões não são obrigatórias, mas podem melhorar sua experiência:

ExtensãoO que fazPor que é útil
Error Lens (usernamehw.errorlens)Mostra erros e avisos diretamente na linha do códigoAjuda iniciantes a identificar problemas sem precisar abrir o painel de "Problemas"
indent-rainbow (oderwat.indent-rainbow)Coloriza os níveis de indentaçãoEm Python, a indentação define a estrutura do código — visualizar os níveis ajuda a evitar erros
Portuguese Language Pack (MS-CEINTL.vscode-language-pack-pt-BR)Traduz a interface do VS Code para portuguêsPara quem prefere menus e mensagens em português

Temas de ícones (icon themes)​

Os temas de ícones substituem os ícones padrão do VS Code por ícones diferenciados para cada tipo de arquivo e pasta. Isso facilita a navegação no Explorer, especialmente à medida que o projeto vai crescendo.

Para aplicar um tema de ícones: File → Settings → Themes → File Icon Theme (ou Ctrl+Shift+P / Cmd+Shift+P → "Preferences: File Icon Theme").

TemaIdentificadorPor que é útil
Material Icon ThemePKief.material-icon-themeO mais popular do marketplace; ícones distintos para dezenas de tipos de arquivo e pastas (ex.: pasta src, docs, tests ganham ícones próprios), tornando a estrutura do projeto muito mais legível
vscode-iconsvscode-icons-team.vscode-iconsAlternativa clássica com ampla cobertura de linguagens e frameworks; boa opção se preferir um visual diferente do Material

:::tip Dica O Material Icon Theme é recomendado para iniciantes por ter ícones intuitivos e fáceis de distinguir à primeira vista. :::

O Terminal Integrado​

:::note Conceito: Terminal O terminal (também chamado de console ou linha de comando) é uma interface baseada em texto para interagir com o sistema operacional. Em vez de clicar em ícones, você digita comandos para executar programas, navegar entre pastas e gerenciar arquivos. O VS Code possui um terminal integrado — isso significa que você pode escrever código e executá-lo na mesma janela, sem precisar alternar entre aplicativos. :::

Como abrir o terminal integrado​

Pressione Ctrl + ` (a tecla de crase, ao lado do 1 no teclado).

Ou use o menu: Terminal → Novo Terminal.

O terminal será aberto na parte inferior da janela do VS Code, usando o PowerShell ou o Prompt de Comando do Windows.

Os 5 comandos que você precisa saber​

Nesta disciplina, você vai usar o terminal principalmente para executar scripts Python. Aqui estão os cinco comandos essenciais:

1. Verificar a versão do Python​

python --version

Confirma que o Python está instalado e acessível. Saída esperada: Python 3.14.3 (ou versão similar).

2. Executar um script Python​

python nome_do_arquivo.py

Este é o comando mais importante desta disciplina. Substitua nome_do_arquivo.py pelo nome real do seu arquivo.

3. Ver em qual pasta você está​

cd

No Windows, digitar cd sem argumentos mostra o diretório atual.

Útil para verificar se o terminal está na mesma pasta do seu arquivo Python.

4. Navegar para uma pasta​

cd nome_da_pasta

Entra na pasta especificada. Para voltar uma pasta acima:

cd ..

5. Abrir uma pasta no VS Code​

code .

Abre a pasta atual no VS Code. Útil quando você quer abrir um projeto inteiro.

:::tip Dica Quando você abre uma pasta no VS Code (via Arquivo → Abrir Pasta ou code .), o terminal integrado já abre automaticamente nessa pasta. Isso evita a necessidade de navegar com cd. :::

Primeiro Script: Hello World​

Agora que Python e VS Code estão instalados, vamos juntar tudo e executar o seu primeiro programa.

:::note Conceito: Script Um script é um arquivo de texto contendo instruções em uma linguagem de programação. O interpretador Python lê o script linha a linha e executa cada instrução na ordem. Em Python, os scripts têm a extensão .py. :::

Passo 1: Crie uma pasta para seus projetos​

Crie uma pasta no seu computador para guardar os arquivos desta disciplina. Sugestão: algoritmos dentro da sua pasta de Documentos.

Abra essa pasta no VS Code: Arquivo → Abrir Pasta (ou File → Open Folder) e selecione a pasta criada.

Passo 2: Crie o arquivo hello.py​

  1. No VS Code, clique no ícone de Novo Arquivo no explorador lateral (ou pressione Ctrl+N / Cmd+N)
  2. Salve o arquivo como hello.py (Ctrl+S / Cmd+S) dentro da pasta que você criou

Passo 3: Escreva o código​

Digite o seguinte código no arquivo hello.py:

print("Hello, World!")

A função print() exibe uma mensagem no terminal. É a forma mais básica de o programa "falar" com o usuário.

Passo 4: Execute o script​

Abra o terminal integrado (Ctrl + ` ou Cmd + `) e execute:

python hello.py

Passo 5: Verifique a saída​

O terminal deve exibir:

Hello, World!

Se você vê essa mensagem, parabéns! Você acabou de executar o seu primeiro programa em Python.

:::tip Experimentando Tente modificar a mensagem dentro de print() e execute novamente. Por exemplo:

print("Meu nome é [seu nome] e estou aprendendo Python!")

Execute o script e veja a nova saída. A programação é feita de pequenas experiências como essa. :::

Problemas Comuns e Soluções​

Se algo não funcionou como esperado durante a instalação, consulte os cenários abaixo. Eles cobrem os problemas mais frequentes em cursos introdutórios de programação.

1. Python não reconhecido no terminal (Windows)​

Sintoma: ao digitar python no terminal, aparece a mensagem 'python' não é reconhecido como um comando interno ou externo ou o Windows abre a Microsoft Store.

Causa: durante a instalação, a opção "Add python.exe to PATH" não foi marcada.

Solução:

  1. Abra o instalador do Python novamente (baixe de python.org se necessário)
  2. Selecione "Modify" (Modificar)
  3. Avance até a tela de opções avançadas
  4. Marque "Add Python to environment variables"
  5. Clique em "Install"
  6. Feche e reabra o terminal, depois teste com python --version

2. Terminal abre a Microsoft Store em vez do Python (Windows)​

Sintoma: ao digitar python ou python3, em vez de executar o Python, o Windows abre a página do Python na Microsoft Store.

Causa: o Windows possui aliases de execução de aplicativo que redirecionam os comandos python e python3 para a Store, mesmo quando o Python já está instalado.

Solução:

  1. Abra Configurações do Windows (Win + I)
  2. Vá em Aplicativos → Configurações avançadas de aplicativo → Aliases de execução de aplicativo
  3. Desative as entradas python.exe e python3.exe que apontam para o "Instalador de Aplicativo"
  4. Feche e reabra o terminal
  5. Teste com python --version

3. Comando python não funciona, mas python3 funciona (macOS/Linux)​

Sintoma: digitar python retorna "command not found", mas python3 funciona normalmente.

Causa: o macOS (desde o Catalina) não inclui mais o Python do sistema, e muitas distribuições Linux criam apenas o executável python3. O comando python sem o número pode não existir.

Solução:

Use sempre python3 em vez de python no macOS e Linux. Todos os exemplos desta disciplina usam python3 nas instruções para esses sistemas. No VS Code, certifique-se de que o interpretador selecionado aponta para python3:

  1. Pressione Cmd+Shift+P (macOS) ou Ctrl+Shift+P (Linux)
  2. Digite "Python: Select Interpreter"
  3. Selecione a versão que inclui python3 no caminho

4. VS Code não reconhece o Python / IntelliSense não funciona​

Sintoma: o VS Code mostra "No Python interpreter selected" na barra de status, ou o autocompletar e a verificação de erros não funcionam.

Causa: o VS Code não conseguiu detectar automaticamente a instalação do Python, ou há múltiplas versões instaladas e ele escolheu a errada.

Solução:

  1. Pressione Ctrl+Shift+P para abrir a Paleta de Comandos
  2. Digite "Python: Select Interpreter"
  3. Selecione a versão que você acabou de instalar (ex.: Python 3.14.3 em C:\Users\...\Python314\python.exe)
  4. Verifique que a barra de status (canto inferior esquerdo) mostra a versão correta

5. Erro de permissão durante a instalação (Windows)​

Sintoma: o instalador do Python falha com uma mensagem de erro sobre permissões, ou pede uma senha de administrador que você não tem.

Causa: o instalador padrão tenta gravar arquivos em C:\Program Files, que requer permissão de administrador.

Solução:

  1. Execute o instalador do Python novamente
  2. Selecione "Customize installation" (Personalizar instalação)
  3. Na tela de opções avançadas, marque "Install for all users" como desmarcado
  4. O Python será instalado na pasta do seu usuário (C:\Users\seu_nome\AppData\Local\...), sem precisar de permissão de administrador

:::info Último recurso: ambientes online Se nenhuma das soluções acima resolver o problema (ex.: computador muito restrito, ChromeOS, ou equipamento institucional), você pode usar um ambiente de programação online como alternativa temporária:

  • Replit — editor online com terminal integrado
  • Google Colab — notebooks Python no navegador

Esses ambientes permitem escrever e executar código Python sem instalar nada. Porém, o ambiente local (Python + VS Code) é o recomendado para a disciplina, pois oferece a experiência completa de desenvolvimento. :::

Exercícios / Checkpoints​

Realize cada exercício abaixo para confirmar que seu ambiente está funcional. Cada checkpoint tem um critério de verificação claro — se o resultado corresponder ao esperado, você pode seguir em frente.

Checkpoint 1: Versão do Python​

python --version

Critério: o terminal exibe Python 3.14.x (ou versão 3.10+).

Checkpoint 2: Extensão Python no VS Code​

Abra o VS Code e pressione Ctrl+Shift+X / Cmd+Shift+X. Verifique que a extensão Python (Microsoft) está instalada e habilitada.

Critério: a extensão aparece na lista com o status "Habilitado" e o ícone da Microsoft.

Checkpoint 3: Interpretador selecionado​

Abra qualquer arquivo .py no VS Code e observe a barra de status (canto inferior esquerdo). Deve exibir a versão do Python (ex.: Python 3.14.3).

Critério: a barra de status mostra o interpretador Python correto. Se mostrar "Select Interpreter", clique e selecione a versão instalada.

Checkpoint 4: Hello World​

Crie (ou reutilize) o arquivo hello.py e execute:

python hello.py

Critério: o terminal exibe Hello, World!.

Checkpoint 5: Script com cálculo​

Crie um arquivo chamado soma.py com o seguinte conteúdo:

a = 5
b = 3
resultado = a + b
print("A soma é:", resultado)

Execute o script no terminal.

Critério: o terminal exibe A soma é: 8.

Checkpoint 6: Navegação no terminal​

No terminal integrado, execute os comandos abaixo na ordem:

cd
mkdir teste_python
cd teste_python
cd ..

Critério: os comandos executam sem erros; você consegue entrar e sair de uma pasta pelo terminal.

Resumo da Aula​

Nesta aula, você configurou o seu ambiente de desenvolvimento completo:

  • ✅ Python 3.14 instalado e acessível pelo terminal
  • ✅ VS Code instalado com a extensão Python (que inclui Pylance, Debugger e Environments)
  • ✅ Terminal integrado do VS Code utilizado para verificar a instalação e executar scripts
  • ✅ Primeiro script (hello.py) criado e executado com sucesso
  • ✅ Comandos essenciais do terminal aprendidos: verificar versão, executar script, navegar entre pastas

Próxima aula: Tipos de Dados e Variáveis — onde você vai aprender a armazenar e manipular informações em Python

Referências​

Leitura Essencial​

Aprofundamento (Opcional)​