Перейти к содержанию
Scissor LaTeX

Частые ошибки и как их исправить

Большинство проблем не останавливает документ: неизвестные команды пропускаются и перечисляются на вкладке «Проблемы», формула, которую не удаётся прочитать, показывается красным и называется там, а отсутствующие изображения и цитаты отмечаются на месте; весь документ останавливает только изображение EPS.

Как сообщается о проблемах

Установленный TeX останавливается на первой ошибке и спрашивает, что делать. Scissor LaTeX продолжает работу: он верстает столько документа, сколько может, и перечисляет то, с чем не справился, на вкладке «Проблемы» под предпросмотром. У каждой записи указана строка, к которой она относится, если она известна, и щелчок по записи переходит к ней.

Бывает четыре вида результата:

Что вы видитеЧто это значитКуда смотреть
Сообщение на вкладке «Проблемы», документ в порядкеЧто-то было пропущено или опущено.Разделы ниже.
Формула показана красным исходным кодомЭту формулу не удалось прочитать.Красные формулы
Красный [key?] или серая пунктирная рамкаОтсутствует цитата или изображение.Отсутствующие цитаты и изображения
Страниц нет совсем, ошибка вверхуВесь документ не удался.Когда не верстается весь документ

«Skipped N unknown commands»

Это сообщение вы будете видеть чаще всего, и оно соответствует ошибке LaTeX «Undefined control sequence». Команда, которую Scissor LaTeX не знает, пропускается: её имя исчезает, а текст в её фигурных скобках остаётся.

Неизвестная команда: имя исчезает, текст остаётся

LaTeXОткрыть в редакторе
The value is \highlightvalue{44} and the unit is \unitname{kg}.

Вкладка «Проблемы»: Skipped 2 unknown commands: \highlightvalue, \unitname

Что делать:

  • Проверьте написание. \textbf работает, \textbold нет.
  • Если команда взята из пакета, найдите этот пакет на страницах пакетов. У некоторых команд есть простая замена.
  • Если это ваша собственная команда, проверьте, что она определена через \newcommand до первого использования (см. Собственные команды).

С неизвестным окружением всё иначе: оно молча удаляется, а его содержимое остаётся, без какого-либо сообщения. Если текст выглядит неоформленным, проверьте имя окружения.

«Package ... is not available here»

\usepackage никогда не приводит к ошибке. Пакет, который Scissor LaTeX не знает, отмечается на вкладке «Проблемы», и его оформление не применяется. Остальной документ верстается как обычно, а незнакомые команды из пакета отмечаются как неизвестные.

Недоступный пакет

LaTeXОткрыть в редакторе
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}

Вкладка «Проблемы»: Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.

Красные формулы

Если в формуле есть что-то, что преобразователь математики не может прочитать, эта формула показывается красным исходным кодом. Остальной документ это не затрагивает. Вкладка «Проблемы» называет формулу, её строку и причину, например «This formula could not be read: \symbf{v} (unknown command: \symbf)»; после десяти формул ещё одна строка сообщает, сколько осталось.

\symbf недоступна, поэтому формула красная

LaTeXОткрыть в редакторе
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.

Красным: формулу не удаётся прочитать, поэтому вместо неё показан исходный код.

Частые причины и способы исправления:

ПричинаИсправление
\abs{x}, \norm{x}, \dv{f}{x} (physics)\left\lvert x \right\rvert, \left\lVert x \right\rVert, \frac{df}{dx}
\SI{44}{\kilo\gram} (siunitx)44\,\mathrm{kg}
\sidesetПерепишите формулу без неё.
$ без парыЗакройте формулу. Незакрытый $ не становится красным: он превращает остаток абзаца, до следующей пустой строки, в слитную курсивную математику.

Отсутствующие цитаты и изображения

Ключ цитаты, которого нет ни в одном файле .bib, печатается красным [key?], а вкладка «Проблемы» перечисляет отсутствующие ключи. Отсутствующее изображение становится серой пунктирной рамкой с именем файла.

Изображение, которого нет в проекте

LaTeXПреамбула: \usepackage{graphicx}Открыть в редакторе
\begin{figure}[h]
  \centering
  \includegraphics[width=0.5\linewidth]{figures/plot.png}
  \caption{A plot that has not been uploaded yet.}
\end{figure}
Свёрстано в Scissor LaTeX: Изображение, которого нет в проекте

Вкладка «Проблемы»: Images not in the project: figures/plot.png

Загрузите файл в проект по тому же пути или исправьте путь. Без расширения находятся файлы .png, .jpg, .jpeg и .svg; для рисунков PDF и EPS тоже показывается рамка (см. Рисунки и изображения). О цитатах см. Списки литературы и цитирование.

Другие сообщения

СообщениеЗначениеЧто делать
«N included files are not part of this conversion»\subfile, \import, \lstinputlisting, \inputminted или \includepdf пропущены.Используйте \input или вставьте содержимое.
«File not found: ...»\input или \include называет файл, которого нет в проекте.Проверьте путь от верхней папки проекта.
«N pictures of an unsupported kind are not included»Окружение tikzcd, circuitikz, forest или picture опущено.См. Рисунки в TikZ.
«TikZ option '...' is not supported yet»Рисунок использует параметр, неизвестный движку рисования. Рисунок рисуется без него.Проверьте параметр или уберите его.
«Layout in the style of ... Not official.»Класс или пакет конференции переключил на похожий макет.Ничего; это информация.
«Macro expansion stopped at the safety limit»Команда раскрывается сама в себя или в огромный объём текста.Поищите \newcommand, который использует собственное имя.
«This formula could not be read: ...»Формула показана красным; причина указана в скобках.См. Красные формулы.
«References to labels that do not exist (shown as ??): ...»\ref, \eqref, \pageref или \cref называет метку, которая не определена или стоит в красной формуле.Проверьте написание метки.
«Bibliography style ... is not available; using numbered references [1] instead»\bibliographystyle называет стиль, которого нет в списке, например alpha.Выберите стиль из списка или оставьте нумерованные ссылки.
«Skipped .bib entries: ...»Эти записи файла .bib не удалось прочитать (пропущена скобка, повторяется ключ); остальные используются.Исправьте запись в указанной строке.

Ошибки LaTeX, которых вы здесь не увидите

Некоторые классические ошибки LaTeX в Scissor LaTeX ничего не останавливают, поэтому их легко не заметить:

Ошибка LaTeXЧто делает Scissor LaTeX
«Missing $ inserted» для x_1 в текстеПечатает x_1 буквально. Помещайте математику в $...$.
«Misplaced alignment tab character &»Печатает & буквально. Для амперсанда пишите \&.
«Extra }, or forgotten $»Игнорирует несбалансированные фигурные скобки.
«\begin{itemize} ended by \end{document}»Закрывает окружение за вас.
«Reference ... undefined»Печатает полужирные ??; вкладка «Проблемы» перечисляет отсутствующие метки.

Текст, который LaTeX отверг бы

LaTeXОткрыть в редакторе
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.

В установленном TeX такие документы всё равно могут не компилироваться, поэтому исправляйте их, даже если предпросмотр выглядит нормально.

Отличия от установленного TeX

Список проверок по симптомам см. на странице Решение проблем.

Вопросы и ответы

Что означает «Undefined control sequence»?

LaTeX не знает команду, обычно из-за опечатки или неподключённого пакета. В Scissor LaTeX та же ситуация отображается как «Skipped N unknown commands» на вкладке «Проблемы», а документ всё равно верстается.

Почему моя формула красная?

В формуле есть команда, которую не знает преобразователь математики, например \symbf или \abs. Вкладка «Проблемы» называет её. Замените эту команду; таблица на этой странице перечисляет частые замены.

Почему я вижу [key?] в документе?

Ключа цитаты нет ни в одном файле .bib проекта. Проверьте написание и то, что файл .bib загружен.

Каждый пример на этой странице верстается в Scissor LaTeX при сборке сайта. Обновлено 2026-11-07.