Curso de Python / Escrever, executar e depurar um script no VS Code

Para executar Python no VS Code, instale o interpretador separadamente e selecione o ambiente do projeto no editor. Abrir a pasta do projeto e conferir o caminho de Python e de pip ajuda a evitar que o código seja executado em um ambiente diferente daquele que recebeu os pacotes.

Prepare o editor e abra a pasta do projeto

Este exercício pressupõe que você já tenha Python 3.12 ou posterior e uma pasta python-lab com o ambiente .venv. O VS Code é o editor; a extensão Python acrescenta recursos de edição, execução e depuração, mas não substitui o interpretador. Para preparar a instalação no seu sistema, consulte os procedimentos para Windows ou macOS e Ubuntu.

Na área de extensões do VS Code, procure a extensão Python e confirme que o publicador é Microsoft. O tutorial oficial de Python no VS Code apresenta os componentes necessários. Se você usa uma versão localizada do editor, os nomes dos menus podem aparecer traduzidos; os nomes de comandos em inglês abaixo ajudam a encontrá-los.

Use File → Open Folder, ou Arquivo → Abrir Pasta, e selecione python-lab. Abrir só um arquivo não define a pasta de trabalho da mesma maneira. Mantenha o arquivo do exercício na raiz dessa pasta, fora de .venv.

Selecione e verifique o interpretador

1. Abra a paleta de comandos com Ctrl+Shift+P no Windows ou Linux, ou Cmd+Shift+P no macOS. Execute Python: Select Interpreter.
2. Escolha o interpretador da pasta .venv do projeto. Se ele não aparecer, confira se o ambiente foi criado corretamente e atualize a descoberta de ambientes. Se o seletor oferecer a entrada de um caminho, informe o executável correspondente.
3. Abra um novo terminal integrado pelo menu Terminal → New Terminal e execute as duas verificações abaixo.

python -c "import sys; print(sys.executable)"
python -m pip --version

O primeiro caminho deve apontar para .venv\Scripts\python.exe no Windows ou .venv/bin/python no macOS e Ubuntu. O caminho mostrado por pip também deve ficar dentro do ambiente. A versão exata de pip pode variar; o ponto importante aqui é a localização.

Um terminal aberto anteriormente pode conservar a seleção antiga. A ativação automática também depende das configurações e do shell. Se python ainda apontar para outro local, confira a seleção e a ativação; para verificar o ambiente diretamente, você pode usar o caminho completo do executável com os mesmos argumentos. A documentação de ambientes Python no VS Code detalha a descoberta e a seleção.

Salve e execute um script completo

Crie expense.py na pasta python-lab, com o conteúdo completo abaixo. Salve em UTF-8. Este programa usa apenas funções embutidas e não precisa de um pacote adicional nem de dados externos.

amounts = [3500, 8000, 2500]
total = sum(amounts)
print(f"total={total}")

Com esse arquivo ativo no editor, use Run Python File da extensão Python, ou a opção Run Python → Run Python File in Terminal no menu de contexto. No terminal que usa o ambiente correto, também é possível executar python expense.py. A saída esperada é:

total=14000

amounts contém os três valores, sum(amounts) calcula a soma e a última linha a mostra. Troque apenas 8000 por 9000, salve e execute novamente: a saída deve ser total=15000. Restaure 8000, salve e confira a volta de total=14000. Se o resultado não mudar, verifique qual arquivo foi salvo e executado.

Compare a execução normal com a depuração

Depurar significa acompanhar a execução e inspecionar o estado do programa. Antes de comparar os resultados, abra um novo terminal após qualquer troca de interpretador e repita as verificações abaixo. Este bloco é a mesma checagem de ambiente, agora usada para investigar uma possível diferença entre execução normal e depuração:

python -c "import sys; print(sys.executable)"
python -m pip --version

1. Em expense.py, coloque um ponto de interrupção na terceira linha, a de print(...), clicando na margem à esquerda do número da linha.
2. Pressione F5. Se houver uma seleção de configuração, escolha a opção Python para executar o arquivo atual, como Python File.
3. Quando o programa parar nessa linha, abra a área Variables. amounts deve conter [3500, 8000, 2500], e total deve valer 14000. A linha destacada ainda será executada; a atribuição da linha anterior já ocorreu.
4. Use F10 para avançar sobre a instrução ou F5 para continuar. Confira a mesma saída da execução normal. Depois, remova o ponto de interrupção clicando novamente na margem.

A documentação de depuração Python descreve a extensão Python Debugger e as configurações. Por padrão, a depuração usa o ambiente selecionado, mas uma configuração existente em launch.json pode especificar outro interpretador. Confira esse arquivo se a execução normal funcionar e a depuração falhar.

• Um import falha depois de instalar o pacote: compare o executável e o caminho de pip. Use python -m pip com o mesmo Python que executa o arquivo.
• O arquivo não é encontrado: confira o nome completo e a pasta atual do terminal.
• Um módulo padrão apresenta comportamento inesperado: evite nomes locais como json.py ou csv.py, que podem ocultar módulos da biblioteca padrão.
• Outro botão de execução produz um resultado diferente: identifique qual extensão forneceu o botão. Comece comparando o comando da extensão Python com o terminal do projeto.