> 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/uk/zapitannya-ta-vidpovidi/81-tips-and-tricks-for-troubleshooting-latex.md).

# Поради та прийоми для усунення неполадок у LaTeX

Є кілька порад і прийомів, які можна використати, щоб допомогти виявити й вирішити проблеми LaTeX. Зазвичай ми рекомендуємо налагоджувати з [увімкненим режимом компіляції Stop on First Error](/latex/uk/baza-znan/149-using-the-stop-on-first-error-compilation-mode.md), оскільки це дозволить уникнути накопичення помилок. Коли ви натрапите на помилку, ви можете виконати такі кроки, щоб її виправити:

1. **Це помилка чи попередження?**

   Почніть із значка «Журнали та вихідні файли», який розташований праворуч від кнопки повторної компіляції.

   ![Індикатор попередження в значку «Журнали та вихідні файли»](/files/30683ed81c7f16369ed10ff876fec6a25b5539db)

   Повідомлення про попередження показуються помаранчевим кольором. Часто це лише сповіщення про те, що LaTeX виявив щось незвичайне й автоматично вніс коригування. Якщо вони не впливають на остаточний вигляд вашого документа, їх зазвичай можна ігнорувати.

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

   ![Індикатор помилки в значку «Журнали та вихідні файли».](/files/0b4451096ffcce3ec5e3a25ddcf26c5e8981781b)

   Повідомлення про помилки показуються червоним кольором. Зазвичай вони проблемніші й можуть завадити правильній компіляції документа. Фатальні помилки можуть повністю запобігти компіляції документа.

   Є список поширених помилок і способів їх виправлення [тут](/latex/uk/osnovi-latex/05-errors.md). Ми рекомендуємо виправляти помилки якнайшвидше, оскільки їх накопичення може призвести до важких для налагодження та фатальних помилок у майбутньому.
2. **Чи вказує повідомлення на конкретну помилку або номер рядка?**

   ![Повідомлення про помилку з указаним номером рядка.](/files/9b581c97a0153f569b74e037f2aeb54fec8e98e2)

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

   Якщо номер рядка не вказано, продовжуйте пробувати деякі з наведених нижче кроків.
3. **Чи дає текст помилки підказку?**

   ![Повідомлення про помилку, яке вказує, що проблема в файлі .bbl, що свідчить про проблему з бібліографією.](/files/e3c8c5c4aac1ba5821c0a000b0b87548eda64da8)

   У наведеному вище повідомленні про помилку вказано номер рядка, але не для файлу, який ви зазвичай редагуєте. Тут розширення файлу .bbl дає підказку, що помилка, яка заважає компіляції, пов’язана з BibTeX.

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

   Якщо ваш проєкт раніше компілювався без проблем, то, ймовірно, ви внесли помилку в проєкт у своїх останніх змінах. Ви можете скористатися [функцією Історія](/latex/uk/inshi-temi/49-using-the-history-feature.md) щоб відкочувати нещодавні зміни.
5. **Спробуйте перемістити \end{document}**

   Якщо ви все ще не звузили місце помилки, виріжте `\end{document}` з самого кінця вашого головного файлу .tex і спробуйте вставляти його в різні частини вашого проєкту. Почніть із головного файлу .tex, а потім, за потреби, із будь-яких підфайлів, які ви викликаєте в головному файлі за допомогою `\input{}` або `\include{}`. Рухайтеся методично від самого кінця проєкту/документа до початку документа, повторюючи цей процес по одному розділу за раз. Особливу увагу звертайте на рівняння або інші складні розділи, схильні до дрібних помилок.

   Це має допомогти вам поступово звужувати документ до дедалі меншого фрагмента, поки ви не зможете ізолювати розділ, що містить помилку. Якщо документ раптом починає компілюватися, ви знаєте, що знайшли помилковий розділ. У багатьох випадках проблема може бути настільки простою, як помилково введена команда, спеціальний символ без екранування або відсутня дужка.
6. **Це помилка компіляції «тайм-аут»?**

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

   Як і з іншими онлайн-сервісами, під час використання Overleaf іноді можуть виникати проблеми. Стан браузера, розширення браузера, короткочасні збої в роботі постачальників послуг і проблеми з мережевою конфігурацією можуть потенційно спричиняти проблеми.

   Якщо у вас виникають проблеми з підключенням або якщо частина редактора чи переглядача PDF не завантажується або не відображається належним чином, спробуйте кроки з усунення неполадок на [цю сторінку](/latex/uk/baza-znan/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/uk/zapitannya-ta-vidpovidi/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.