정의되지 않은 제어 시퀀스

알 수 없는 명령 이름: 오타, 누락된 패키지, 잘못된 엔진.

정의되지 않은 제어 시퀀스

증상

컴파일이 ! 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가 복구한 뒤에는 그다음 내용을 잘못 읽을 수 있기 때문입니다. 로그에서 처음 나온 정의되지 않은 제어 시퀀스를 고치고, 다시 컴파일한 다음에 남은 것을 살펴보세요.

로그 읽기(으)로 돌아가기