Quando algo não funciona · Programa com Martin

Um capítulo de resgate. Todo o programador fica bloqueado às vezes – até os melhores. Eis o que fazer.

Primeiro, o mais importante

Quando algo não funciona, não é culpa tua e não estragaste nada. Ficar bloqueado é uma parte completamente normal da programação. Os programadores profissionais lidam com bugs todos os dias – a única diferença é que aprenderam a caçá-los com calma.

A regra de ouro: lê com atenção

90% de todos os bugs no código são erros de escrita. Os computadores são incrivelmente exigentes:

<h1> funciona, <hl> não (o número um vs. um L minúsculo)
index.html funciona, index. html não (um espaço a mais)
Cada etiqueta de abertura <p> precisa da sua etiqueta de fecho </p>

Compara o teu código com o código da lição letra a letra. Normalmente encontras o erro num minuto.

Problemas comuns e como resolver

”Abre-se como texto simples, não como página”

O teu ficheiro provavelmente não se chama index.html, mas algo como index.html.txt. No VS Code, apaga o ficheiro e cria um novo – o nome tem de acabar exatamente em .html.

”Mudei o código, mas nada mudou na página”

Duas causas mais comuns:

Esqueceste-te de guardar – prime Ctrl+S (Cmd+S no Mac). Um ficheiro por guardar tem um ponto ao lado do nome no VS Code em vez de um X.
Esqueceste-te de atualizar a página – prime F5 no browser.

”Há símbolos estranhos na página em vez de letras acentuadas”

O cabeçalho do teu ficheiro não tem a linha <meta charset="UTF-8">. Adiciona-a entre <head> e </head> – diz ao browser que conjunto de caracteres o teu texto usa.

”A imagem não aparece, só um ícone de imagem partida”

Verifica o nome do ficheiro no teu código – tem de ser exatamente igual ao nome do ficheiro na tua pasta, incluindo a extensão (photo.jpg não é o mesmo que photo.JPG ou photo.jpeg).
A imagem tem de estar na mesma pasta que o teu index.html (ou no caminho de pasta que escreveste no código, como images/photo.jpg).

”De repente metade da página fica a negrito / gigante / azul”

Em algum sítio esqueceste-te de uma etiqueta de fecho. Por exemplo, <strong> não tem o seu </strong>, por isso tudo fica a negrito até ao fim. Encontra onde começa a estranheza e adiciona a etiqueta de fecho em falta.

Quando ainda estás bloqueado

Faz uma pausa. A sério. Cinco minutos a olhar pela janela e o bug muitas vezes resolve-se sozinho. Até os profissionais fazem isto.
Lê a parte partida em voz alta. Parece parvo, mas funciona – ler em voz alta faz-te reparar em coisas que os olhos saltam.
Pede um segundo par de olhos. Um pai, uma mãe, um irmão, um amigo – não precisam de saber programar, só de comparar o teu código com a lição.
Recomeça uma parte pequena. Quando é demais, apaga a última parte que adicionaste, verifica que a página funciona outra vez, depois adiciona de novo – mais devagar desta vez.

💡

Lembra-te: cada bug que resolves torna-te um programador melhor. Depurar não é uma tarefa chata, é um superpoder que estás a construir agora.