> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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 会报告一种特殊的警告， [“underfull”和“overfull”盒子警告](/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://ayakaleaf-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.