未定义的控制序列

未知的命令名称:拼写错误、缺少宏包、引擎错误。

未定义的控制序列

症状

编译停止,并显示 ! Undefined control sequence.。随后日志显示出错的那一行,分成两部分:TeX 已读取的所有内容(包括有问题的命令)在同一行上,源代码行的其余部分在它下方。上一行的最后一个标记就是 TeX 无法识别的命令,这让该错误成为最容易精确定位的错误之一。

为什么会发生

控制序列是以反斜杠开头的任何内容。 TeX 没有固定的词汇表:命令之所以存在,只是因为内核、文档类、某个宏包或你自己的 \newcommand 定义了它们。当 TeX 读到一个反斜杠后跟一个未被任何东西定义的名称时,它无法猜测你的意图,于是停止。这个错误从来不是说命令在一般意义上是“错误的”,而是说这个名称在本文档中、此时此刻、此引擎下是未知的。

通过三项检查修复它

首先检查拼写。把 \textbf 拼成 \texbf,把 \label 拼成 \lable,或者一个多余的空格把名称拆成两半,这涵盖了大多数情况。日志的行号能直接带你找到拼写错误。

如果拼写正确,那么定义它的宏包很可能缺失。 \includegraphics 在没有 \usepackage{graphicx} 时毫无作用,\toprule 需要 booktabs,\SI 需要 siunitx。当你从另一个文档或模型的回答中复制片段时,这种情况最让人头疼:正文跟过来了,导言区的那一行却没有。在每个命令详解中查找哪个宏包定义了该命令,添加 \usepackage 行,然后重新编译。如果宏包本身没有安装,请参阅安装缺失的宏包。

如果宏包已加载而错误仍然存在,就要怀疑引擎了。有些命令只在特定引擎下存在:\fontspec 及其相关命令需要 XeLaTeX 或 LuaLaTeX,在 pdfLaTeX 下会以这个错误终止。在文档中指定引擎的模板通常正是出于这个原因。 这个项目该用哪个引擎解释了其中的差异。

两个值得了解的怪癖

顺序很重要:在定义它的 \usepackage 行之前使用的命令在该处仍然是未定义的,所以要把宏包加载保留在导言区、\begin{document} 的上方。而且一个错误常常掩盖另一个错误,因为 TeX 恢复后可能会误读其后的所有内容。先修复日志中第一个未定义的控制序列,重新编译,然后再看剩下的问题。

返回 日志素养