HomeCasa Prompts

Depurar um erro passo a passo

Encontre a causa raiz de um erro de programação com um método de diagnóstico estruturado, em vez de remendos às cegas. Pensado para ChatGPT, Claude, Gemini e Microsoft Copilot. Inclui 5 variáveis personalizáveis e pode copiá-lo gratuitamente com um clique.

Iniciante · Código · Pendente de revisão editorial

Pensado para:

Prompt

Age como um engenheiro de software sénior especialista em depuração. Tenho um erro num projeto em {{language}}.

Mensagem de erro / comportamento:
```
{{error}}
```

Código relevante:
```
{{code}}
```

O que esperava que acontecesse: {{expected}}
O que já tentei: {{tried}}

Segue este processo e não saltes passos:
1. Explica em linguagem simples o que significa o erro.
2. Lista as 3 causas mais prováveis por ordem de probabilidade, fundamentando cada uma com evidências do código.
3. Para a causa mais provável, explica como a confirmar (o que registar em log, o que verificar).
4. Propõe a correção mínima e mostra apenas as linhas alteradas.
5. Explica porque é que a correção funciona e se pode afetar outras partes.
6. Sugere um teste que teria detetado este erro.

Se te faltar informação para teres confiança, pergunta-me antes de propores uma solução.

Como utilizar

Inclua a mensagem de erro completa (com o stack trace) e apenas o código relacionado. Remova chaves de API, palavras-passe e dados pessoais antes de colar.

Exemplo de utilização

Linguagem: JavaScript · Erro: TypeError: Cannot read properties of undefined (reading 'map') ao carregar uma lista a partir de uma API.

Exemplo de resultado

1. O que significa o erro

Está a chamar .map() sobre algo que vale undefined. Em React isto acontece normalmente no primeiro render, antes de chegarem os dados da API.

2. Causas mais prováveis

  1. O estado começa sem valor (useState<Product[]>()) e é renderizado antes de o fetch terminar.
  2. A API devolve outra estrutura, por exemplo { data: [...] }, e está a guardar o objeto inteiro.
  3. Um erro de rede silencioso: o catch deixa o estado em undefined.

3. Como confirmar

Acrescente console.log('products', products) imediatamente antes do return e veja a resposta no separador Rede.

4. Correção mínima

const [products, setProducts] = useState<Product[]>([]);

useEffect(() => {
  fetch(API_URL)
    .then((res) => res.json())
    .then((json: { data?: Product[] }) => setProducts(json.data ?? []));
}, []);

Inicializar com [] faz com que o primeiro render mostre uma lista vazia em vez de falhar, e ?? [] protege contra respostas sem data. Não afeta outras partes, a menos que algo dependa de products ser undefined.

Como ainda não vi o seu código, confirme-me a estrutura exata da resposta da API…

Dados-chave

Categoria
Programação e desenvolvimento · Depuração
Tipo de resultado
Código
Nível
Iniciante
Pensado para
ChatGPT, Claude, Gemini e Microsoft Copilot
Verificado em
Pendente de verificação editorial
Variáveis
Linguagem / framework, Mensagem de erro, Código relevante, Comportamento esperado e O que tentou
Idioma
Português
Preço
Gratuito, sem registo
Atualizado
07/11/2026

Perguntas frequentes

Quanto código devo colar?

A função onde o erro acontece, o código que a chama e a mensagem de erro ou o stack trace completo. Remova antes palavras-passe, chaves de API e dados pessoais.

Porque é que a IA me faz perguntas em vez de dar a solução?

É intencional: uma correção baseada em suposições pode esconder a causa real. Responda às perguntas ou faça as verificações sugeridas e cole os resultados.

Para que serve este prompt?

Encontre a causa raiz de um erro de programação com um método de diagnóstico estruturado, em vez de remendos às cegas.

Com que ferramentas de IA funciona?

Foi pensado para ChatGPT, Claude, Gemini e Microsoft Copilot. Ainda não o verificámos nestas ferramentas, pelo que os resultados podem variar entre elas.

Como personalizo o prompt?

Clique em “Personalizar” e preencha as variáveis (Linguagem / framework, Mensagem de erro, Código relevante, Comportamento esperado e O que tentou). O texto atualiza-se instantaneamente e pode depois copiá-lo com um clique. Os valores ficam guardados apenas no seu navegador.

Preciso de experiência para o utilizar?

Não. É um prompt de nível iniciante: basta preencher os dados e colá-lo na sua ferramenta de IA.

Este prompt é gratuito?

Sim. Todos os prompts do HomeCasa Prompts são gratuitos, sem registo nem subscrição. Pode também utilizá-los em projetos profissionais.

Posso confiar no resultado da IA?

Trate-o como um rascunho de qualidade: verifique sempre os dados, os números e as afirmações importantes antes de publicar ou tomar decisões.

Prompts relacionados