未定義の制御綴り(Undefined control sequence)

認識されないコマンド名。原因は、タイプミス、パッケージの不足、エンジンの違い。

未定義の制御綴り(Undefined control sequence)

症状

コンパイルが ! Undefined control sequence. で止まります。その後、ログには、エラーが起きた行が 2 つに分かれて表示されます。上の行には、問題のコマンドまでに TeX が読み込んだすべてが入り、ソースの行の残りが、その下に出ます。上の行の最後にあるトークンが、TeX が認識できなかったコマンドです。そのため、これは原因の位置を正確に突き止めやすいエラーの 1 つです。

なぜ起こるのか

制御綴りとは、バックスラッシュで始まるものすべてです。TeX には決まった語彙がありません。コマンドが存在するのは、カーネル、文書クラス、パッケージ、あるいは自分で書いた \newcommand が、それを定義したからにすぎません。TeX がバックスラッシュに続く名前を読んだとき、それを定義したものが何もなければ、意図を推測できずに止まります。このエラーは、そのコマンドが一般に「間違っている」という意味ではありません。この文書の、この位置の、このエンジンでは、その名前が未知だという意味です。

3 つの確認で直す

まず、綴りを確認します。\textbf が \texbf になっている、\label が \lable になっている、名前の途中にうっかり空白が入って 2 つに分かれている、といった例が、大半を占めます。ログに出る行番号をたどれば、タイプミスにすぐ行き着きます。

綴りが合っているなら、そのコマンドを定義するパッケージが足りない可能性が高いです。\includegraphics は \usepackage{graphicx} がないと何もしません。\toprule には booktabs が、\SI には siunitx が必要です。特に起こりやすいのは、別の文書や AI の回答からスニペットをコピーしたときです。本文は一緒に来ても、プリアンブルの行は付いてきません。どのパッケージがそのコマンドを定義しているかは、すべてのコマンドの解説 で調べ、\usepackage の行を追加して、もう一度コンパイルします。パッケージ自体がインストールされていない場合は、足りないパッケージをインストールする を見てください。

パッケージを読み込んでもエラーが続くなら、エンジンを疑います。コマンドの中には、特定のエンジンでしか存在しないものがあります。\fontspec とその関連コマンドは XeLaTeX か LuaLaTeX が必要で、pdfLaTeX で使うと、まさにこのエラーで止まります。テンプレートの説明でエンジンを指定していることが多いのは、たいていこのためです。違いは、このプロジェクトにはどのエンジンを使うか で説明しています。

知っておきたい 2 つの癖

順序が重要です。コマンドを定義する \usepackage の行より前で使ったコマンドは、その時点ではまだ未定義です。パッケージの読み込みは、\begin{document} より上のプリアンブルにまとめてください。また、1 つのエラーが別のエラーを隠すことがよくあります。TeX は、エラーから復旧した後、それ以降を読み違えることがあるためです。ログで最初に出た未定義の制御綴りを直して、再コンパイルしてから、残っているものを見てください。

ログ読解 に戻る