Quem está começando costuma ver um bloco de texto vermelho e fechar a janela. Só que essa mensagem é a melhor pista que você tem. Aprender a lê-la poupa horas.
Anatomia de uma mensagem de erro
Quase toda mensagem traz três informações:
- O tipo do erro, como erro de sintaxe, de nome não definido ou de tipo incorreto.
- A descrição, uma frase explicando o que deu errado.
- O local: arquivo e número da linha onde o problema apareceu.
Em muitas linguagens, a lista de chamadas (stack trace) mostra o caminho. Costuma valer olhar a linha que pertence ao seu código, e não às bibliotecas.
Passo a passo para depurar
- Leia a mensagem inteira, devagar. Repare no tipo do erro e no arquivo.
- Vá até a linha indicada e olhe também as linhas de cima. Às vezes o erro real está antes, como um parêntese não fechado.
- Reproduza o problema. Encontre os passos mínimos que fazem o erro aparecer sempre.
- Isole. Comente trechos ou crie um exemplo pequeno só com o que falha.
- Inspecione valores. Imprima variáveis no ponto suspeito ou use o depurador do editor para pausar a execução.
- Mude uma coisa por vez e teste. Várias mudanças juntas escondem o que funcionou.
Erros comuns de iniciante
- Erros de digitação em nomes de variáveis e funções.
- Indentação errada em linguagens que dependem dela.
- Usar uma variável antes de ela receber valor.
- Misturar tipos, como somar texto com número.
- Arquivo ou caminho que não existe.
Usar IA e controle de versão
Uma IA pode explicar a mensagem em linguagem simples e sugerir hipóteses. Entenda a sugestão antes de aplicar e nunca cole chaves ou senhas; veja como usar inteligência artificial para programar. E antes de mexer muito, salve o estado atual com Git, para poder voltar atrás; o guia Git no dia a dia: commit, branch e como desfazer erros mostra como.
Quando pedir ajuda
Se travou depois de investigar, peça ajuda em fóruns ou comunidades com o erro completo, o código mínimo que falha e o que você já tentou. Perguntas claras recebem respostas melhores.
