> 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/zh-cn/wen-da/81-tips-and-tricks-for-troubleshooting-latex.md).

# LaTeX 故障排查技巧

有一些技巧和窍门可用于帮助识别并解决 LaTeX 问题。我们通常建议你在启用 [“在第一个错误处停止”编译模式](/latex/zh-cn/zhi-shi-ku/149-using-the-stop-on-first-error-compilation-mode.md)的情况下进行调试，因为这样可以避免错误堆积。一旦遇到错误，你可以按照以下步骤进行解决：

1. **这是错误还是警告？**

   先查看“日志和输出文件”图标，它位于重新编译按钮的右侧。

   ![“日志和输出文件”图标中的警告指示器](/files/42b74c8397ccdd156e63c034d45496e0ca9a8120)

   警告信息以橙色显示。这些通常只是提示 LaTeX 发现了某些异常情况并进行了自动调整。如果它们不会影响文档的最终外观，通常可以忽略。

   例如，许多浮动对象以及边距/间距问题都会被 LaTeX 自动修正，无需用户干预。Overleaf 会报告一种特殊的警告， [内容不足和内容溢出框警告](/latex/zh-cn/zhi-shi-ku/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors)，以蓝色显示——其中大多数可以安全忽略，不过它们有时也会指出文档中需要检查的部分。

   ![“日志和输出文件”图标中的错误指示器。](/files/ca854a405d4ddc9ca1fff89f768e42bf0a56ac19)

   错误信息以红色显示。它们通常更严重，可能会阻止文档正常编译。致命错误甚至可能使文档完全无法编译。

   这里有一份常见错误及其解决方法列表 [这里](/latex/zh-cn/latex-ji-chu/05-errors.md)。我们建议尽快更正错误，因为让它们累积起来可能会在以后导致难以调试的致命错误。
2. **该消息是否指出了具体错误或行号？**

   ![包含行号的错误信息。](/files/c0d98f88a791a3506e109bd31570d8982ca8f785)

   在许多情况下，LaTeX 引擎足够智能，能够准确找出错误并给出行号。在上面的示例中，有一个符号 `_`，而 LaTeX 要求你像这样对其进行转义： `\_`。错误信息甚至指出错误在第 29 行，高亮显示了相应行，并展示了问题所在文本的片段。你可以点击错误信息，直接跳转到源代码中出现错误的文件和行号。

   如果没有指示行号，请继续尝试下面的一些步骤。
3. **错误文本是否提供了线索？**

   ![一条错误信息指出问题出在 .bbl 文件中，暗示是参考文献方面的问题。](/files/2351b09d66e3925c7d78d712e3775b34dbcf2b70)

   在上面的错误信息中，给出了一个行号，但并不是你通常编辑的文件中的行号。这里，文件扩展名 .bbl 提供了线索，说明阻止编译的错误是一个 BibTeX 问题。

   在你的 .bib 文件中搜索高亮文本可以帮助你找到错误来源。有时 [检查辅助文件和日志文件](/latex/zh-cn/zhi-shi-ku/150-view-generated-files.md) 可能会比简短的消息对话框提供更具体的信息。
4. **比较以前的版本并回退更改**

   如果你的项目之前编译一直正常，那么你最近的编辑很可能在项目中引入了错误。你可以使用 [历史记录功能](/latex/zh-cn/geng-duo-zhu-ti/49-using-the-history-feature.md) 来回退最近的更改。
5. **尝试移动 \end{document}**

   如果你仍然没有缩小错误位置的范围，请剪切 `\end{document}` 从主 .tex 文件的最末尾开始，并尝试将其粘贴到项目的各个部分。先从主 .tex 文件开始，然后在必要时，再处理你在主文件中通过 `\input{}` 或 `\include{}`调用的任何子文件。以有条不紊的方式，从项目/文档的最后部分逐步向文档开头移动，每次重复处理一个部分。要特别注意公式或其他容易出现小错误的复杂部分。

   这应当有助于你逐步把文档缩小到越来越小的范围，直到能够隔离出包含错误的部分。如果文档突然开始能够编译，你就知道你已经找到了有问题的部分。在许多情况下，问题可能只是一个拼写错误的命令、一个未转义的特殊字符，或者一个缺失的括号。
6. **这是编译“超时”错误吗？**

   在某些情况下，用户可能会在特定条件下遇到编译超时错误。这是由于我们服务器上的资源/编译时间限制。我们对免费账户和付费账户设置了不同的时间限制。为了 [让你的文档编译更快](/latex/zh-cn/zhi-shi-ku/038-fixing-and-preventing-compile-timeouts.md)，我们提供了若干提示；如果这些方法不起作用，欢迎向我们提交 [支持请求](https://www.overleaf.com/contact).
7. **这是“PDF 渲染”错误吗？**

   和其他在线服务一样，在使用 Overleaf 时你有时也会遇到问题。浏览器状态、浏览器扩展、服务提供商的短暂中断以及网络配置问题都可能导致故障。

   如果你遇到连接问题，或者编辑器或 PDF 查看器的某部分没有按预期加载或显示，请尝试 [此页面](/latex/zh-cn/zhi-shi-ku/125-resolving-access-loading-and-display-problems.md).
8. **试试论坛**

   如果没有给出行号，而且你也无法理解所给出的错误信息，快速“复制粘贴”到你常用的搜索引擎中，可能会发现遇到过类似问题的专家用户提供的信息。一些很棒的 TeX 相关论坛包括 [LaTeX Stack Exchange](https://tex.stackexchange.com/) 和 [LaTeX Community](https://latex.org/forum/).
9. **联系我们**

   最后但同样重要的是，你始终可以给我们发送一条 [支持请求](https://www.overleaf.com/contact)。无论你的问题是什么，无论是 LaTeX 相关还是网站相关，我们都很乐意帮助你充分利用 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/zh-cn/wen-da/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.