Ver templatesBrowse
{ TexDrop }

Como corrigir erros comuns no LaTeX: guia de diagnóstico

English: Read this tutorial in English.

Erros de compilação no LaTeX parecem enigmáticos no começo, mas quase sempre podem ser resolvidos com um método simples: localizar a primeira mensagem relevante, identificar o comando ou arquivo envolvido e testar a correção em um exemplo mínimo. Este guia reúne os problemas mais frequentes no Overleaf, Windows e Linux.

Comece pelo primeiro erro do log

Uma falha inicial pode gerar dezenas de mensagens secundárias. Por isso, não comece pelo último aviso. Abra o log completo, encontre o primeiro trecho marcado como erro e observe a linha indicada. Leia também uma ou duas linhas antes dela: muitas vezes a causa está em uma chave, ambiente ou comando iniciado anteriormente.

Depois de corrigir o primeiro erro, compile novamente. Repita o processo até o documento voltar a ser gerado.

Undefined control sequence

Essa mensagem significa que o compilador não reconheceu um comando. As causas mais comuns são erro de digitação, pacote ausente ou comando incompatível com o compilador escolhido.

! Undefined control sequence.
l.18 \inclduegraphics{grafico.pdf}

No exemplo, \inclduegraphics foi digitado incorretamente. O comando correto é \includegraphics, fornecido pelo pacote graphicx:

\usepackage{graphicx}
...
\includegraphics[width=.8\textwidth]{grafico.pdf}

Missing $ inserted

Caracteres e comandos matemáticos precisam estar em modo matemático. Um sublinhado usado diretamente no texto, por exemplo, costuma provocar esse erro.

valor_final        % incorreto em texto comum
valor\_final      % sublinhado literal
$valor_{final}$     % expressão matemática

Verifique também se todos os delimitadores $...$, \(...\) e \[...\] foram fechados.

File not found

O LaTeX não encontrou uma imagem, arquivo incluído, classe ou banco bibliográfico. Confirme o nome completo, a extensão, as letras maiúsculas e minúsculas e a pasta relativa ao arquivo principal.

\includegraphics{figuras/resultado.pdf}
\input{capitulos/metodo}
\addbibresource{referencias.bib}

Em servidores Linux e no Overleaf, Grafico.pdf e grafico.pdf são nomes diferentes. Evite espaços e acentos em nomes de arquivos para facilitar a portabilidade.

Referências e citações aparecem como ??

Referências cruzadas exigem mais de uma compilação. Citações com BibLaTeX normalmente exigem Biber entre as execuções do LaTeX.

pdflatex main
biber main
pdflatex main
pdflatex main

Confira se a chave usada em \ref{...} ou \cite{...} existe, se o arquivo .bib foi declarado e se o projeto está usando a ferramenta bibliográfica correta. No Overleaf, tente Recompile from scratch quando arquivos auxiliares estiverem desatualizados.

Runaway argument e chaves desequilibradas

Mensagens como Runaway argument?, File ended while scanning use of... ou Extra } normalmente indicam uma chave ou ambiente não fechado.

\textbf{Texto sem fechar

\begin{figure}
  ...
% faltou \end{figure}

Use a correspondência de delimitadores do editor e recolha temporariamente partes do documento. Se o erro desaparecer, reative os blocos aos poucos até localizar a região problemática.

Caracteres Unicode e fontes

Se o documento usa muitas fontes do sistema ou vários alfabetos, prefira XeLaTeX ou LuaLaTeX com fontspec. Em projetos pdfLaTeX modernos, mantenha os arquivos em UTF-8 e use uma distribuição atualizada.

% XeLaTeX ou LuaLaTeX
\usepackage{fontspec}
\setmainfont{TeX Gyre Pagella}

Não carregue fontspec com pdfLaTeX. Confirme o compilador nas configurações do projeto antes de trocar pacotes de fonte.

Overfull e Underfull hbox

Essas mensagens são avisos de composição, não necessariamente erros fatais. Overfull \hbox indica conteúdo ultrapassando a margem; URLs longas, tabelas largas e palavras sem pontos de quebra são causas comuns.

  • Use \url{...} com o pacote hyperref.
  • Ajuste larguras de colunas e prefira tabularx para tabelas extensas.
  • Reescreva a frase antes de forçar espaçamentos manuais.
  • Não use \sloppy globalmente sem revisar o resultado visual.

Crie um exemplo mínimo reproduzível

Copie o problema para um arquivo pequeno, mantendo apenas a classe, os pacotes necessários e o trecho que falha:

\documentclass{article}
\usepackage{amsmath}

\begin{document}
  % trecho que apresenta o erro
\end{document}

Se o exemplo mínimo compilar, a causa está em outra parte do projeto ou na interação entre pacotes. Reintroduza os elementos gradualmente. Esse método também torna pedidos de ajuda muito mais claros.

Fluxo de diagnóstico recomendado

  1. Faça uma cópia ou salve uma versão estável do projeto.
  2. Leia o primeiro erro real do log.
  3. Vá à linha indicada e examine o bloco anterior.
  4. Confira chaves, ambientes, nomes de arquivos e pacotes.
  5. Limpe arquivos auxiliares e compile novamente.
  6. Reduza o problema a um exemplo mínimo.
  7. Consulte a documentação do pacote usando o texto exato da mensagem.

Checklist final

  • O compilador escolhido é compatível com os pacotes?
  • Todos os arquivos usam nomes simples e estão no projeto?
  • Chaves, colchetes, ambientes e modos matemáticos estão fechados?
  • Referências foram compiladas o número necessário de vezes?
  • O primeiro erro do log foi corrigido antes dos demais?

Com esse processo, a maioria dos erros deixa de ser uma sequência misteriosa de mensagens e passa a ser um problema localizado e verificável. Para praticar, use um dos templates LaTeX da TexDrop e faça alterações em pequenas etapas.