Todo programador encontra erros, inclusive os experientes. A diferença está em como investigam. Depurar bem é seguir uma sequência simples, em vez de mexer no código ao acaso até funcionar.
1. Leia a mensagem de erro inteira
A mensagem costuma dizer o tipo do erro, o arquivo e a linha onde ele apareceu. Leia do início ao fim antes de qualquer coisa. Em muitos casos, o erro real está na primeira ou na última linha da mensagem, e o meio é só o caminho percorrido pelo programa.
Se a mensagem estiver em inglês, copie o trecho principal, sem dados sensíveis, e pesquise. Outras pessoas provavelmente já tiveram o mesmo problema.
2. Reproduza o problema
Descubra exatamente o que causa o erro. Ele acontece sempre ou só com certos dados? Em qual ação? Se você não consegue repetir o problema, não consegue saber se corrigiu. Anote os passos que levam ao erro.
3. Isole o trecho que falha
Reduza o problema ao menor pedaço possível. Algumas formas de fazer isso:
- Comente partes do código e veja se o erro some.
- Teste a função com um valor simples, separada do resto do programa.
- Volte a uma versão que funcionava e compare. Com Git, isso fica mais fácil: veja Git no dia a dia.
4. Observe o que o código faz de verdade
Muitas vezes o código faz algo diferente do que você imagina. Há duas ferramentas principais:
- Logs ou prints: mostre o valor das variáveis em pontos estratégicos para confirmar se elas têm o que você espera.
- Depurador: pause o programa em um ponto de parada, chamado breakpoint, e avance linha a linha. A maioria dos editores, como o VS Code, tem essa função. O nome dos menus pode variar conforme a versão.
Verifique dados de entrada também. Um erro comum é receber um dado em formato diferente do esperado, como um texto onde era um número. Se o dado vem de uma API, ver o formato ajuda: leia JSON: o que é e como ler.
5. Teste uma hipótese por vez
Formule uma explicação, faça uma mudança pequena e teste. Se mudar cinco coisas de uma vez, você não saberá qual delas resolveu, e pode criar novos erros.
Quando pedir ajuda
Se travou, peça ajuda com um bom relato: o que esperava, o que aconteceu, a mensagem completa de erro e o trecho de código envolvido. Remova senhas, chaves e dados pessoais antes de compartilhar. Isso vale também ao usar assistentes de IA, cujas respostas devem ser testadas e não aceitas às cegas.