未定義的控制序列
不認得的命令名稱:打字錯誤、缺少套件、引擎不對。
未定義的控制序列
症狀
編譯停在 ! Undefined control sequence.。接著日誌會顯示出錯的那一行,並且拆成兩段:上面是 TeX 已讀到的所有內容,包括出問題的那個命令;下面是這行原始碼剩下的部分。上面那一行的最後一個記號,就是 TeX 不認得的命令,所以這是比較容易準確定位的錯誤之一。
為什麼會發生
控制序列是任何以反斜線開頭的東西。TeX 沒有固定的詞彙表:命令之所以存在,只是因為核心、文件類別、套件或你自己的 \newcommand 定義了它們。當 TeX 讀到反斜線後面接著一個沒有任何東西定義過的名稱時,它無法猜出你的意思,就會停下來。這個錯誤從來不是說命令本身「不對」,而是說這個名稱在這份文件中、在這個位置、在目前這個引擎下是未知的。
用三項檢查來修正
先檢查拼字。把 \textbf 打成 \texbf、把 \label 打成 \lable,或是一個多餘的空格把名稱拆成兩半,就能解釋大多數的情況。日誌中的行號會直接帶你找到打錯的地方。
如果拼字沒問題,很可能是缺了定義該命令的套件。沒有 \usepackage{graphicx},\includegraphics 就沒有作用;\toprule 需要 booktabs;\SI 需要 siunitx。當你從別份文件或模型的回答中複製片段時,最容易遇到這種情況:正文帶過來了,序言中的那一行卻沒有。你可以在每個命令逐一解釋中查出是哪個套件定義了這個命令,加上 \usepackage 那一行,然後重新編譯。如果套件本身沒有安裝,請見安裝缺少的套件。
如果套件已經載入,錯誤仍然存在,就要懷疑引擎。有些命令只存在於特定的引擎:\fontspec 和相關命令需要 XeLaTeX 或 LuaLaTeX,在 pdfLaTeX 下就會因為這個錯誤而失敗。範本的說明文件中指定了引擎,通常就是這個原因。此專案該用哪個引擎說明了其中的差異。
兩個值得知道的怪癖
順序很重要:在定義該命令的 \usepackage 那一行之前使用它,在那個位置仍然是未定義的,所以請把載入套件的敘述放在序言中、\begin{document} 之前。另外,一個錯誤常常會掩蓋另一個錯誤,因為 TeX 恢復之後,可能會誤讀接下來的所有內容。請先修正日誌中的第一個未定義控制序列,重新編譯,再去看剩下的問題。