> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/perguntas-e-respostas/81-tips-and-tricks-for-troubleshooting-latex.md).

# Dicas e truques para resolver problemas no LaTeX

Existem algumas dicas e truques que pode usar para ajudar a identificar e resolver problemas no LaTeX. Em geral, recomendamos que depure com o [modo de compilação Parar no Primeiro Erro ativado](/latex/overleaf-learn-latex-pt/base-de-conhecimento/149-using-the-stop-on-first-error-compilation-mode.md), pois isso permitirá evitar o acúmulo de erros. Depois de encontrar um erro, pode seguir estes passos para o resolver:

1. **Existe um erro ou aviso?**

   Comece por olhar para o ícone "Registos e ficheiros de saída", imediatamente à direita do botão Recompilar.

   ![Um indicador de aviso no ícone "Registos e ficheiros de saída"](/files/b7ec713daac4a8e7396e5d9bf55eff14e915c039)

   As mensagens de aviso são mostradas a laranja. Muitas vezes, são apenas alertas de que o LaTeX encontrou algo fora do normal e fez ajustes automáticos. Se não tiverem impacto no aspeto final do seu documento, normalmente podem ser ignoradas.

   Por exemplo, muitos problemas de flutuação e de margem/espaçamento são corrigidos pelo LaTeX sem necessidade de intervenção do utilizador. O Overleaf assinala uma classe especial de aviso, [avisos de caixas subcheias e sobrecheias](/latex/overleaf-learn-latex-pt/base-de-conhecimento/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors), a azul — a maioria pode ser ignorada em segurança, embora por vezes destaquem uma parte do documento que precisa de ser verificada.

   ![Um indicador de erro no ícone "Registos e ficheiros de saída".](/files/1c01a129c076681d70cf5938ec11ea447ebb0dc6)

   As mensagens de erro são mostradas a vermelho. Normalmente são mais problemáticas e podem impedir que o documento compile corretamente. Erros fatais podem impedir a compilação do documento por completo.

   Existe uma lista de erros comuns e de como os resolver [aqui](/latex/overleaf-learn-latex-pt/nocoes-basicas-de-latex/05-errors.md). Recomendamos que os erros sejam corrigidos assim que possível, pois deixá-los acumular-se pode levar a erros fatais e difíceis de depurar no futuro.
2. **A mensagem indica um erro específico ou um número de linha?**

   ![Uma mensagem de erro com um número de linha incluído.](/files/7864078a323958e7c63ed8bc0308bb7fa0e19013)

   Em muitos casos, o motor LaTeX é suficientemente inteligente para descobrir o erro exato e dar-lhe um número de linha. No exemplo acima, havia um símbolo `_`, que o LaTeX exige que seja escapado assim: `\_`. A mensagem de erro até indica que o erro está na linha 29, destaca a linha apropriada e mostra um excerto do texto onde o problema se encontra. Pode clicar na mensagem de erro para saltar diretamente para o ficheiro e número de linha onde o erro ocorre no código-fonte.

   Se não for indicado nenhum número de linha, continue a experimentar alguns dos passos abaixo.
3. **O texto do erro dá alguma pista?**

   ![Uma mensagem de erro que indica que o problema está no ficheiro .bbl, sugerindo um problema com a bibliografia.](/files/49c9f2367aa7c11a0b6d03e5747185dc7acee09b)

   Na mensagem de erro acima, é dado um número de linha, mas não de um ficheiro que normalmente edita. Aqui, a extensão de ficheiro, .bbl, dá a pista de que o erro que está a impedir a compilação é um problema do BibTeX.

   Procurar o texto destacado no seu ficheiro .bib permitirá encontrar a origem do erro. Por vezes [verificar os ficheiros auxiliares e de registo](/latex/overleaf-learn-latex-pt/base-de-conhecimento/150-view-generated-files.md) pode revelar informações mais específicas do que as breves caixas de diálogo de mensagem.
4. **Compare versões anteriores e reverta alterações**

   Se o seu projeto estava a compilar bem anteriormente, então é provável que tenha introduzido um erro no projeto nas suas edições recentes. Pode usar a [funcionalidade Histórico](/latex/overleaf-learn-latex-pt/mais-topicos/49-using-the-history-feature.md) para reverter alterações recentes.
5. **Tente mover \end{document}**

   Se ainda não tiver reduzido a localização do erro, corte o `\end{document}` a partir do fim do seu ficheiro .tex principal e tente colá-lo em várias partes do seu projeto. Comece pelo ficheiro .tex principal e depois, se necessário, em quaisquer subficheiros que invoque no ficheiro principal com `\input{}` ou `\include{}`. Desloque-se de forma metódica desde o fim do projeto/documento até ao início do documento, repetindo este processo uma secção de cada vez. Preste especial atenção a equações ou outras secções complicadas propensas a pequenos erros.

   Isto deverá ajudá-lo a restringir progressivamente o seu documento a um documento cada vez mais pequeno até conseguir isolar a secção que contém o erro. Se o documento começar de repente a compilar, sabe que localizou a secção errada. Em muitos casos, o problema pode ser algo tão simples como um comando mal escrito, um carácter especial não escapado ou um parêntese em falta.
6. **É um erro de compilação de "tempo limite"?**

   Em alguns casos, os utilizadores podem enfrentar erros de compilação por timeout em determinadas condições. Isto deve-se aos limites de tempo de compilação/recursos nos nossos servidores. Temos limites de tempo diferentes para contas gratuitas e contas pagas. Há uma série de dicas que temos para [fazer o seu documento compilar mais rapidamente](/latex/overleaf-learn-latex-pt/base-de-conhecimento/038-fixing-and-preventing-compile-timeouts.md), e se isto não funcionar, não hesite em contactar-nos com um [pedido de apoio](https://www.overleaf.com/contact).
7. **É um erro de "renderização de PDF"?**

   Tal como acontece com outros serviços online, por vezes pode encontrar problemas ao utilizar o Overleaf. O estado do navegador, extensões do navegador, interrupções breves dos fornecedores de serviços e problemas de configuração de rede podem potencialmente causar problemas.

   Se estiver a ter problemas de ligação, ou se parte do editor ou do visualizador de PDF não estiver a carregar ou a ser apresentado como esperado, experimente os passos de resolução de problemas em [esta página](/latex/overleaf-learn-latex-pt/base-de-conhecimento/125-resolving-access-loading-and-display-problems.md).
8. **Experimente os fóruns**

   Se não for indicado nenhum número de linha e não conseguir decifrar a mensagem de erro fornecida, uma rápida ida de "copiar e colar" ao seu motor de busca favorito pode revelar informações de utilizadores especialistas que enfrentaram um problema semelhante. Alguns excelentes fóruns relacionados com TeX incluem [LaTeX Stack Exchange](https://tex.stackexchange.com/) e [Comunidade LaTeX](https://latex.org/forum/).
9. **Contacte-nos**

   Por fim, mas não menos importante, pode sempre enviar-nos um [pedido de apoio](https://www.overleaf.com/contact). Independentemente do seu problema, seja específico do LaTeX ou do sítio, teremos todo o gosto em ajudá-lo a tirar o máximo partido da sua experiência no Overleaf.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/perguntas-e-respostas/81-tips-and-tricks-for-troubleshooting-latex.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.