Use Run Code / Run (Executar Código) quando você quiser executar seu programa e ver sua saída. Use Debug quando você quiser pausar em uma linha, inspecionar variáveis e descobrir por que um resultado está errado. A depuração é especialmente útil quando seu código é executado sem erro, mas produz uma resposta inesperada.
Este guia usa o executor Python CodeUtility e um pequeno exemplo de cálculo. O fluxo de trabalho de breakpoint e passo também se aplica a outros executores onde o Debug está disponível. O suporte e os controles em tempo de execução podem variar; use um runtime de servidor suportado para este tutorial em Python. As capturas de tela mostram a interface em inglês.
1. Tente um pequeno programa com um bug de lógica
Abra o executor Python, escolha Python 3.11 no menu de versão e insira as seguintes quatro linhas. Um preço de 12 multiplicado por uma quantidade de 3 deve resultar em 36. Este programa usa deliberadamente adição, então produz 15.
price = 12
quantity = 3
total = price + quantity
print(total)2. Defina um breakpoint antes de iniciar o Debug
Clique na margem esquerda ao lado da linha 3, a linha que contém total = price + quantity. Um marcador de breakpoint vermelho aparece. Um breakpoint informa ao depurador onde pausar. Clique no marcador novamente para removê-lo. Coloque breakpoints em declarações executáveis em vez de linhas em branco ou comentários.
3. Inicie o Debug e inspecione os valores
Selecione Debug na barra de ferramentas do editor; passe o mouse sobre um ícone para ver seu rótulo. Aguarde a janela do depurador relatar Paused at line 3 (Pausado na linha 3). Pausado significa que o programa está aguardando sua próxima ação de depuração.
Olhe sob VARIABLES (VARIÁVEIS): price é 12 e quantity é 3. A linha 3 ainda não foi executada, então total não está listado. A linha destacada é a próxima declaração a ser executada. A CALL STACK (PILHA DE CHAMADAS) mostra onde a execução está atualmente pausada.
4. Passe pelo cálculo
Clique em Step Over (Passo Sobre) uma vez. A execução se move para a linha 4, e total agora aparece com o valor 15. Isso mostra que a resposta errada vem da adição dos dois valores na linha 3.
Continue (Continuar) retoma até que outro breakpoint seja alcançado ou o programa termine. Step Over (Passo Sobre) executa a declaração atual sem entrar em uma função chamada. Step Into (Passo Dentro) entra em uma função chamada quando suportado. Step Out (Passo Fora) executa até que a função atual retorne. Stop (Parar), mostrado como um ícone quadrado, encerra a sessão de depuração.
5. Corrija o código e execute novamente
Selecione Continuar para finalizar o exemplo, ou Parar para encerrar a sessão. Substitua o sinal de adição na linha 3 por um sinal de multiplicação, em seguida, selecione Run Code / Run (Executar Código) para verificar a saída. Você deve ver 36. Você também pode iniciar o Debug novamente e usar Passo Sobre para verificar o valor corrigido.
price = 12
quantity = 3
total = price * quantity
print(total)Se a depuração não pausar onde você espera
Verifique se um breakpoint vermelho está definido antes de iniciar o Debug, se você selecionou Debug e se o programa realmente alcança essa linha. Escolha uma linha executável e confirme se o runtime selecionado suporta depuração. Erros de sintaxe podem impedir que a execução alcance um breakpoint. Se seu programa solicitar entrada, forneça-a no terminal para que a execução possa continuar.
Para sua próxima sessão de depuração, coloque um breakpoint logo antes do cálculo suspeito, inspecione suas entradas e avance até encontrar o primeiro valor inesperado. Se você só precisar da saída final, selecione Executar Código.