Como Debugar Python no VS Code? – Guia Completo, Fácil e Rápido
Você sabe como debugar Python? Sabia que o VS Code tem uma ferramenta própria para depurar códigos? Aprenda como debugar Python no VS Code de forma fácil e rápida!
Para debugar Python no VS Code, abra o arquivo e clique em Run and Debug ou selecione Python Debugger: Debug Python File. Adicione breakpoints clicando ao lado do número da linha para pausar a execução, inspecione e altere variáveis em tempo real e use Step Into, Step Over e Step Out para percorrer o código.
Se quiser pode acompanhar esse conteúdo em formato de vídeo ou pode acessar o nosso Canal do YouTube para mais vídeos!
O que você aprende neste vídeo
Resposta rápida: O debugger do VS Code permite pausar um programa Python, localizar a linha que falhou e inspecionar variáveis e objetos naquele instante. A aula mostra breakpoints comuns e condicionais, alteração temporária de valores, reinício da sessão e os controles Step Into, Step Over e Step Out para percorrer funções.
Neste vídeo (17 min):
- 0:00 - Por que depurar é mais eficiente do que executar um código grande inteiro a cada teste
- 1:00 - Abertura do Run and Debug e escolha de Python Debugger: Debug Python File
- 2:00 - Como o debugger destaca a linha e o comando responsáveis por uma exceção
- 3:00 - Inspeção de variáveis, módulos, objetos e métodos no painel lateral
- 5:00 - Uso de Stop e Restart e criação de um breakpoint ao lado do número da linha
- 6:00 - Execução passo a passo e continuação até o próximo breakpoint
- 8:00 - Alteração temporária de uma variável durante a sessão para testar outro cenário
- 10:00 - Criação de breakpoint condicional com uma expressão Python
- 12:00 - Exemplo isolado com uma função de cálculo para explicar os controles de navegação
- 13:00 - Diferença entre Step Into, que entra na função, e Step Over, que a executa de uma vez
- 14:00 - Uso de Step Out para concluir a função atual e voltar à linha que a chamou
- 16:00 - Quando a depuração de um único arquivo já basta para localizar a origem do problema
Trechos do vídeo:
- Um breakpoint pausa antes da linha marcada e preserva o estado do programa para inspeção.
- Valores alterados no painel do debugger valem apenas para aquela sessão; ao reiniciar, o código volta a defini-los.
- Step Into entra na função, Step Over a executa sem abrir seus passos e Step Out termina a função atual.
Para receber por e-mail o(s) arquivo(s) utilizados na aula, preencha:
Não vamos te encaminhar nenhum tipo de SPAM! A Hashtag Treinamentos é uma empresa preocupada com a proteção de seus dados e realiza o tratamento de acordo com a Lei Geral de Proteção de Dados (Lei n. 13.709/18). Qualquer dúvida, nos contate.
O que você vai ver hoje?
Como Debugar Python no VS Code? – Guia Completo, Fácil e Rápido
Depurar, ou debugar, é uma habilidade essencial para qualquer desenvolvedor. Ela ajuda a identificar e corrigir erros, entender o comportamento do programa e aprimorar suas habilidades de programação.
Uma coisa que poucas pessoas sabem é que o Visual Studio Code (VS Code) oferece um ambiente completo para a depuração, o que torna a tarefa de encontrar e corrigir problemas muito mais prática e eficiente.
Pensando nisso, nesta aula, vou te mostrar o passo a passo de como configurar e utilizar o depurador do VS Code para Python, tornando sua depuração mais produtiva e otimizando seu fluxo de trabalho, além de economizar tempo.
Para usar como exemplo, no material disponível para download você poderá baixar o código de uma automação com Selenium que foi desenvolvida nesta aula: Selenium com Python – Automatize Qualquer Tarefa na Web
Introdução ao Debugging com VSCode
Durante o desenvolvimento de um programa, site ou aplicativo, é comum surgirem bugs, erros que dificultam ou até impedem a execução correta do código, gerando problemas ou resultados inesperados.
Encontrar e identificar esses erros pode ser um processo trabalhoso, especialmente se você tentar fazer isso sem a ajuda de nenhuma ferramenta, executando o código inteiro várias vezes.
Para facilitar essa tarefa, o VS Code oferece o modo de Debug, que permite debugar sem a necessidade de rodar o código completo repetidas vezes.
Esse modo pode ser acessado pelo botão Run and Debug (Executar e Depurar) na barra lateral, identificado por um ícone de Play com um pequeno inseto (bug) sobreposto.
Outra forma de iniciar o debug é selecionando a opção Python Debugger: Debug Python File, localizada no menu de opções ao lado do ícone de “Play” na barra superior do VS Code.
Na primeira vez que você iniciar o depurador, pode surgir uma pergunta sobre qual arquivo ou módulo deseja debugar. Nesse caso, selecione a opção Python File.
Esse modo permite que você execute o código e monitore o estado das variáveis e a execução das funções em tempo real, parando o código em pontos específicos para observar o que está acontecendo e identificar possíveis problemas.
Você verá no topo da página um controle de execução que permite iniciar, avançar etapas, reiniciar ou interromper o debug.
Além disso, o ícone do debug é exibido no terminal do editor de código enquanto o processo está em andamento.
Se o código não contiver nenhum problema, o debugger simplesmente executará o arquivo normalmente, sem exibir mensagens de erro.
Erro no Debug
Quando um erro ocorre durante a execução, o depurador marca a linha problemática e fornece informações detalhadas sobre o erro encontrado.
A mensagem de erro aparece em vermelho, indicando exatamente onde está o problema e qual comando causou o erro, facilitando a correção.
Configurando e Usando Breakpoints
Durante a depuração, você pode definir e utilizar breakpoints. Eles são pontos específicos onde você deseja que a execução do código seja temporariamente interrompida, permitindo a análise detalhada do estado do programa naquele momento.
Para adicionar um breakpoint no VS Code, clique na área ao lado do número da linha onde deseja que o código pare. O VS Code marcará a linha com uma bolinha vermelha, indicando que o código será pausado ali durante a execução.
Ao executar o código no modo de depuração, ele seguirá com a execução normal até atingir a linha do breakpoint, onde pausará automaticamente.
Python ImpressionadorVocê vai aprender a linguagem de Programação que mais cresce no Mundo para fazer automações incríveis, desenvolver sites, fazer análises de dados, trabalhar com Ciência de Dados, Inteligência Artificial, mesmo que você nunca tenha tido nenhum contato com Programação na vida.
Começar agora
Perceba que a linha onde o breakpoint foi ativado fica marcada em amarelo, e o código é suspenso nesse ponto.
Isso permite que você visualize mais informações sobre o programa, verifique ou modifique variáveis e avalie se o comportamento do programa está conforme o esperado.
Existem diferentes tipos de breakpoints que você pode usar para melhorar o processo de debug:
- Breakpoints Simples: São pontos de parada em linhas específicas do código, úteis para monitorar o comportamento em um local específico.
- Breakpoints Condicionais: São breakpoints que dependem de uma condição para serem ativados. Você pode, por exemplo, configurar um breakpoint para que o código só pare quando uma variável atingir um valor específico.
Para configurar um breakpoint condicional, clique com o botão direito do mouse sobre o ponto de parada e selecione Add Conditional Breakpoint.
Na caixa de diálogo, insira uma expressão booleana que possa ser avaliada como Verdadeira (True) ou Falsa (False). Por exemplo, vamos definir a expressão link = “https://google.com”.
Essa condição significa que o breakpoint só será ativado quando o valor do link corresponder ao site do Google, o que evita paradas desnecessárias e torna a depuração mais eficiente.
Assim, você pode configurar o breakpoint para que ele pause o código apenas quando condições específicas forem atendidas.
Perceba que o código ignora o primeiro breakpoint e só pausa no segundo, quando o valor da variável link for o site do Google. Se substituirmos pelo site da Hashtag, o código continuará sem interrupção.
Explorando Variáveis e Objetos em Tempo Real
Uma funcionalidade bastante útil no modo de depuração do VS Code é a janela de variáveis, que exibe em tempo real os valores de todas as variáveis em execução.
Nessa janela, você pode expandir cada variável para visualizar informações detalhadas, incluindo os métodos disponíveis que podem ser aplicados a ela. Além disso, o depurador do VS Code permite modificar os valores das variáveis em tempo real.
Por exemplo, se você perceber que uma variável contém um valor incorreto durante a depuração, não é necessário parar a execução, corrigir o código e reiniciar o processo.
Em vez disso, você pode alterar o valor diretamente na janela de variáveis e continuar a execução para observar o impacto no restante do código.
Para fazer isso, clique duas vezes sobre o valor da variável no painel de variáveis e insira o novo valor. Suponha que você queira testar o comportamento da automação acessando a página do Google.
Nesse caso, pode alterar o valor da variável link diretamente para o URL desejado, enquanto o código original ainda aponta para o link da Hashtag.
Esse recurso economiza tempo e permite que você experimente diferentes cenários sem interromper o fluxo da depuração.
Controles de Execução: Step Into, Step Over e Step Out
Durante o processo de debug, o VS Code exibe um controle de execução na parte superior da tela.
Neste controle, encontramos algumas opções básicas:
- Continue: Continua a depuração de onde ela parou.
- Restart: Reinicia todo o processo de debug.
- Stop: Interrompe e finaliza o processo de depuração.
Além desses comandos, há outras ferramentas que proporcionam um controle maior sobre o debug, permitindo escolher quais partes do código examinar em detalhe e quais apenas avançar. Entre esses comandos estão:
- Step Into
- Step Over
- Step Out
Para facilitar a compreensão, vamos utilizar uma função simples de cálculo de impostos chamada calcular_imposto, que recebe um valor e retorna 30% dele.
faturamento = 1000
def calcular_imposto(valor):
imposto = valor * 0.3
return imposto
imposto = calcular_imposto(faturamento)
print("Faturamento:", faturamento)
print("Imposto:", imposto)
print("Faturamento Líquido:", faturamento - imposto)Observação: Esse código também está disponível no material para download.
Step Into: Entrar na Função
O comando Step Into permite entrar em uma função e ver a execução linha por linha de seu código. Esse comando é útil para acompanhar cada passo dentro da função e entender como cada variável é processada.
Para usar Step Into no exemplo, adicione um breakpoint na linha onde a função calcular_imposto é chamada.
Em seguida, inicie o depurador clicando em Run and Debug no menu lateral. O código irá parar no ponto em que o breakpoint foi colocado.
Ao utilizar Step Into neste momento, o depurador entrará na função calcular_imposto, avançando para a linha imposto = valor * 0.3.
Nesse ponto, você pode observar as variáveis no painel lateral.
Prosseguindo, você verá o valor que será retornado pela função.
Step Out: Sair da Função
O Step Out é usado para sair de dentro de uma função e retornar ao ponto do código de onde ela foi chamada.
No exemplo anterior, ao clicar em Step Out enquanto está dentro da função calcular_imposto, o depurador executará o restante da função e voltará para a linha de onde ela foi chamada, economizando o trabalho de avançar linha por linha.
Step Over: Pular a Função
O comando Step Over permite que o depurador pule a execução detalhada de uma função, avançando diretamente para a próxima linha de código e executando a função por completo.
Esse comando é ideal quando você quer ver o resultado final da função sem precisar verificar cada linha internamente.
Usando o Step Over no exemplo, o depurador executa calcular_imposto e avança direto para o valor retornado pela função.
Quando Usar Cada Comando
Saber como e quando usar cada um desses comandos facilita a debugar e ajuda a navegar pelo código com eficiência:
- Step Into: Ideal para analisar detalhes de uma função, especialmente ao depurar partes complexas ou checar cálculos importantes.
- Step Over: Útil quando você já compreende o funcionamento interno de uma função e quer apenas avançar para a próxima etapa do código.
- Step Out: Indicado quando, ao entrar em uma função, percebe que não precisa vê-la em detalhes e quer retornar ao fluxo principal.
Perguntas frequentes
1. Como adicionar um breakpoint no VS Code?
Clique na área à esquerda do número da linha onde quer pausar o código — o VS Code marca o ponto com uma bolinha vermelha. Ao rodar em modo de depuração, a execução para nessa linha, permitindo inspecionar variáveis. Para um breakpoint condicional, clique com o botão direito e escolha Add Conditional Breakpoint.
2. Qual a diferença entre Step Into, Step Over e Step Out?
Step Into entra na função chamada e executa linha por linha, ideal para analisar detalhes. Step Over executa a função por completo e avança para a próxima linha, sem entrar nela. Step Out termina a função atual e retorna ao ponto de onde ela foi chamada, economizando passos.
3. É possível alterar variáveis durante a depuração?
Sim. No modo de depuração do VS Code, a janela de variáveis exibe os valores em tempo real. Basta clicar duas vezes sobre o valor de uma variável e digitar um novo valor para testá-lo. Assim você experimenta diferentes cenários sem parar a execução, corrigir o código e reiniciar todo o processo.
4. O que é um breakpoint condicional?
É um breakpoint que só pausa o código quando uma condição é verdadeira. Você clica com o botão direito no ponto de parada, escolhe Add Conditional Breakpoint e informa uma expressão booleana — por exemplo, parar somente quando uma variável atingir determinado valor. Isso evita paradas desnecessárias e agiliza a depuração.
Conclusão – Como Debugar Python no VS Code?
O debugger do VS Code transforma a tarefa de depuração de um código Python em um processo mais eficiente e menos frustrante.
Ferramentas como os breakpoints, a navegação linha a linha e a alteração de variáveis em tempo real oferecem a flexibilidade necessária para identificar e corrigir erros de forma rápida e precisa.
Com a possibilidade de ajustar variáveis em tempo real e explorar os objetos em detalhes, o VS Code facilita o diagnóstico de problemas e ajuda a garantir que o código funcione conforme o esperado.
Nessa aula você pode aprender o passo a passo de como debugar Python com o VS Code! Praticando essas técnicas, você conseguirá se tornar mais eficiente na depuração, resultando em códigos mais robustos e eficientes.
Hashtag Treinamentos
Para acessar outras publicações de Python, clique aqui!
Posts mais recentes de Python
- Curso Básico de Python: Saia do Zero em 10 Aulas Grátis
Aprenda com o curso básico de Python gratuito da Hashtag: 10 aulas práticas, exercícios e projetos reais para sair do zero em programação. - Agentes RAG com Python: como criar um assistente de IA
Aprenda a criar Agentes RAG com Python do zero: LangChain, FAISS e OpenAI para montar um assistente de IA que responde com base nos seus documentos. - 25 Tipos de Gráficos em Python: Guia Completo com Código
Aprenda a criar os principais tipos de gráficos em Python com Plotly: barras, pizza, mapas e mais, com código pronto para copiar e usar.
Posts mais recentes da Hashtag Treinamentos
- Planilha de Controle de Notas Fiscais no Excel [Grátis]
Baixe a planilha de controle de notas fiscais no Excel grátis: calcule ISS e retenções, veja o que está em aberto e gere a cobrança de cada nota de serviço. - Qual IA usar na empresa: ChatGPT, Claude ou Perplexity?
Qual IA usar na empresa: veja as diferenças entre ChatGPT, Claude e Perplexity e quando cada um rende mais em cada área da sua equipe. - Apostilas Gratuitas em PDF: Excel, Power BI, Python e IA
Baixe apostilas gratuitas em PDF de Excel, Power BI, Python, Claude e agentes de IA, com exercícios e gabarito. Escolha a sua e comece hoje.
