Невизначена керуюча послідовність

Симптом

Компіляція припиняється символом ! Невизначена керуюча послідовність. Журнал показує рядок, де це сталося, розбитий на дві частини: усе, що TeX прочитав, аж до неправильної команди включно з одним рядком, а решта вихідного рядка під ним. Останнім маркером у цьому верхньому рядку є команда, яку TeX не розпізнає, що робить цю помилку однією з найпростіших для точного визначення.

Чому це відбувається

Керуюча послідовність — це все, що починається зі зворотної скісної риски. TeX не має фіксованого словника: команди існують лише тому, що їх визначено ядром, класом документа, пакетом або вашою власною \newcommand. Коли TeX читає зворотну косу риску, за якою йде ім’я, яке нічим не визначено, він не може здогадатися, що ви мали на увазі, і зупиняється. Помилка ніколи не полягає в тому, що команда взагалі “неправильна”. Йдеться про те, що ця назва невідома в цьому документі, на даний момент, під цим механізмом.

Виправте це за три перевірки

Спочатку перевірте правопис. \texbf замість \textbf, \lable замість \label або випадковий пробіл, що розбиває ім’я на два облікові записи в більшості випадків. Номер рядка журналу веде вас прямо до друкарської помилки.

Якщо правопис правильний, визначальний пакет, ймовірно, відсутній. \includegraphics нічого не робить без \usepackage{graphicx}, \toprule потребує booktabs, а \SI потребує siunitx. Це найважче, коли ви копіюєте фрагмент з іншого документа або з відповіді моделі: основний текст прийшов, а рядок преамбули – ні. Знайдіть, який пакет визначає команду, у Пояснення кожної команди, додайте рядок \usepackage і перекомпілюйте. Якщо сам пакет не встановлено, див. Встановити відсутній пакет.

Якщо пакет завантажується, а помилка не зникає, підозрюйте двигун. Деякі команди існують лише під певним механізмом: \fontspec та його родичі вимагають XeLaTeX або LuaLaTeX і помруть у pdfLaTeX саме з цією помилкою. Шаблони, які вказують механізм у своїй документації, зазвичай роблять це з цієї причини. Який механізм для цього проекту пояснює відмінності.

Дві особливості, які варто знати

Порядок має значення: команда, яка використовується перед рядком \usepackage, який визначає її, на даний момент ще не визначена, тому зберігайте завантаження пакета в преамбулі над \begin{document}. І одна помилка часто приховує іншу, тому що після відновлення TeX може неправильно прочитати все, що йде далі. Виправте першу невизначену керуючу послідовність у журналі, перекомпілюйте та лише потім дивіться на те, що залишилося.