Сбой компиляции LaTeX: найдите и исправьте ошибку за три шага
Проверьте состояние текущей компиляции, затем изучите первую настоящую ошибку. Последующие сообщения могут быть следствиями той же исходной проблемы, а не отдельными неисправностями.
Шаг 1: проверьте задание и первую ошибку
Дождитесь завершения задания в очереди или выполняемого задания. Откройте панель Bug на панели инструментов, изучите ошибки и Original Log (исходный журнал). Два распространённых формата:
! Undefined control sequence.l.42 \texbf{Результаты}./main.tex:42: Undefined control sequence.Здесь \texbf — опечатка вместо \textbf. Сбои библиографической обработки и тайм-ауты могут сопровождаться другими сообщениями; проверяйте фактическую причину сбоя задания.
Шаг 2: найдите файл, строку и контекст
l.42 или main.tex:42 указывает место обнаружения проблемы TeX, но не обязательно место её возникновения. Пропущенная скобка может проявиться в следующем абзаце. Определите, относится ли ошибка к основному файлу, главе или шаблону, затем проверьте предыдущие группы и границы окружений.
Для записей с корректными файлом и строкой используйте Locate to position (переход к месту). Исправьте первую ошибку, скомпилируйте снова и заново оцените независимые проблемы.
Шаг 3: изолируйте полные блоки в копии
Перед широкими изменениями скачайте исходный проект или сохраните версию для восстановления:
- Сначала проверьте последнюю правку.
- Делите по полным разделам, формулам, таблицам или спискам; не разрезайте аргументы команд.
- Временно уберите примерно половину подозрительного материала, сохранив преамбулу и зависимости.
- Сужайте область в зависимости от того, осталась ли исходная ошибка. Если тест создаёт новые неопределённые команды, восстановите недостающие зависимости.
Видимый PDF не подтверждает успех
- Сгенерированный PDF может сопровождаться предупреждениями; проверьте оформление и выходы за границы.
- Если последний исходник не скомпилировался, предпросмотр может показывать старый результат. Проверьте основной файл и текущее задание.
- Preview with errors — not verified (предпросмотр с ошибками — не проверен) означает, что нужно дальнейшее исследование.
Сравните с минимальным проектом
Создайте пустой тестовый проект, выберите XeLaTeX и поместите этот полный пример в основной файл. Добавляйте исходное содержимое и зависимости постепенно:
\documentclass[a4paper,11pt]{article}\usepackage{fontspec}\setmainfont{CMU Serif}\setsansfont{CMU Sans Serif}\setmonofont{CMU Typewriter Text}\usepackage[russian]{babel}\usepackage{amsmath}\begin{document}Это минимальный тестовый документ.\end{document}Три распространённые ошибки
| Сообщение | Возможная причина | Действие |
|---|---|---|
Undefined control sequence | Опечатка или недостающее определение | Проверьте написание, макросы проекта и пакеты |
Missing $ inserted | Математическое содержимое в текстовом режиме | Используйте математическое окружение, например \(...\) |
Extra }, or forgotten $ | Нарушенные группы или математические ограничители | Проверьте предыдущие скобки и границы математического режима |
Попросите Agent исследовать проблему
AI Fix (исправление с ИИ) в панели Bug открывает Agent и отправляет запрос отладки. Можно обратиться и через Chat & Agent: «Найди первую настоящую ошибку компиляции, внеси только необходимые изменения, скомпилируй и сообщи об оставшихся проблемах». Проверьте изменения и текущее задание, затем изучите PDF.
Для проблем ссылок см. управление библиографией, а для проблем генерации — предотвращение ошибок ИИ.