> 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/ru/voprosy-i-otvety/81-tips-and-tricks-for-troubleshooting-latex.md).

# Советы и приёмы для устранения неполадок LaTeX

Существует несколько советов и приемов, которые можно использовать, чтобы помочь выявить и решить проблемы LaTeX. Обычно мы рекомендуем отлаживать с включенным [режимом компиляции «Остановиться при первой ошибке»](/latex/ru/baza-znanii/149-using-the-stop-on-first-error-compilation-mode.md), так как это позволит избежать накопления ошибок. После того как вы столкнулись с ошибкой, можно выполнить следующие шаги для ее устранения:

1. **Есть ошибка или предупреждение?**

   Начните с просмотра значка «Журналы и выходные файлы», расположенного справа от кнопки «Перекомпилировать».

   ![Индикатор предупреждения в значке «Журналы и выходные файлы»](/files/0b8bbac626fdbf7c514a2280afe16885ac26da82)

   Сообщения предупреждений отображаются оранжевым цветом. Часто это лишь уведомления о том, что LaTeX обнаружил что-то необычное и автоматически внес корректировки. Если они не влияют на конечный вид документа, их обычно можно игнорировать.

   Например, многие проблемы с плавающими объектами и полями/интервалами LaTeX исправляет без вмешательства пользователя. Overleaf сообщает об особом классе предупреждений, [предупреждения о недозаполненных и переполненных коробках](/latex/ru/baza-znanii/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors), синим цветом — большинство из них можно безопасно игнорировать, хотя иногда они указывают на часть документа, которую нужно проверить.

   ![Индикатор ошибки в значке «Журналы и выходные файлы».](/files/4147b2ccbaadb21137c6f634a389c838e10ef067)

   Сообщения об ошибках отображаются красным цветом. Обычно они более серьезны и могут помешать корректной компиляции документа. Фатальные ошибки могут полностью предотвратить компиляцию документа.

   Существует список распространенных ошибок и способов их устранения [здесь](/latex/ru/osnovy-latex/05-errors.md). Мы рекомендуем исправлять ошибки как можно скорее, поскольку их накопление в будущем может привести к трудноотлаживаемым и фатальным ошибкам.
2. **Указывает ли сообщение на конкретную ошибку или номер строки?**

   ![Сообщение об ошибке с указанным номером строки.](/files/3a8d237f84bc8edd698ac262b8812caa25edc167)

   Во многих случаях движок LaTeX достаточно умен, чтобы определить точную ошибку и указать номер строки. В приведенном выше примере был символ `_`, который в LaTeX нужно экранировать так: `\_`. Сообщение об ошибке даже указывает, что ошибка находится в строке 29, выделяет нужную строку и показывает фрагмент текста, где находится проблема. Вы можете щелкнуть по сообщению об ошибке, чтобы перейти прямо к файлу и номеру строки, где ошибка возникает в исходном коде.

   Если номер строки не указан, продолжайте пробовать некоторые из приведенных ниже шагов.
3. **Дает ли текст ошибки какую-либо подсказку?**

   ![Сообщение об ошибке, указывающее, что проблема находится в файле .bbl, что предполагает проблему со списком литературы.](/files/910bb746596f5316fb4ab3bfd2d93d3b08a621cc)

   В приведенном выше сообщении об ошибке указан номер строки, но не для файла, который вы обычно редактируете. Здесь расширение файла .bbl дает подсказку, что ошибка, препятствующая компиляции, связана с BibTeX.

   Поиск выделенного текста в вашем файле .bib позволит найти источник ошибки. Иногда [проверка вспомогательных и лог-файлов](/latex/ru/baza-znanii/150-view-generated-files.md) может дать более конкретную информацию, чем более краткие диалоговые сообщения.
4. **Сравните предыдущие версии и откатите изменения**

   Если ваш проект ранее успешно компилировался, то, вероятно, вы внесли ошибку в проект в ходе последних правок. Вы можете использовать [функцию истории](/latex/ru/drugie-temy/49-using-the-history-feature.md) для отката недавних изменений.
5. **Попробуйте переместить \end{document}**

   Если вы все еще не сузили область поиска ошибки, вырежьте `\end{document}` из самого конца вашего основного файла .tex и попробуйте вставлять его в разные части проекта. Начните с основного файла .tex, а затем, если необходимо, с любых подфайлов, которые вы подключаете в основном файле с помощью `\input{}` или `\include{}`. Двигайтесь методично от самого конца проекта/документа к началу документа, повторяя этот процесс по одному разделу за раз. Особое внимание уделяйте формулам и другим сложным разделам, склонным к мелким ошибкам.

   Это поможет вам постепенно сужать документ до все меньшего и меньшего фрагмента, пока вы не сможете изолировать раздел, содержащий ошибку. Если документ внезапно начинает компилироваться, значит, вы нашли ошибочный раздел. Во многих случаях проблема может быть чем-то таким простым, как опечатка в команде, неэкранированный специальный символ или отсутствующая скобка.
6. **Это ошибка компиляции из-за «тайм-аута»?**

   В некоторых случаях пользователи могут сталкиваться с ошибками компиляции из-за тайм-аута при определенных условиях. Это связано с ограничениями на ресурсы/время компиляции на наших серверах. У нас разные лимиты времени для бесплатных и платных учетных записей. У нас есть ряд советов, чтобы [ускорить компиляцию вашего документа](/latex/ru/baza-znanii/038-fixing-and-preventing-compile-timeouts.md), а если они не помогут, смело обращайтесь к нам с [запросом в службу поддержки](https://www.overleaf.com/contact).
7. **Это ошибка «рендеринга PDF»?**

   Как и в случае с другими онлайн-сервисами, при использовании Overleaf иногда могут возникать проблемы. Состояние браузера, расширения браузера, кратковременные сбои у поставщиков услуг и проблемы с сетевой конфигурацией могут потенциально вызвать неполадки.

   Если у вас возникают проблемы с подключением или если часть редактора или просмотрщика PDF не загружается или не отображается должным образом, попробуйте выполнить шаги по устранению неполадок на [эту страницу](/latex/ru/baza-znanii/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/ru/voprosy-i-otvety/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.