Chuỗi điều khiển chưa được định nghĩa

Tên lệnh không xác định: gõ sai, thiếu gói, dùng sai engine.

Chuỗi điều khiển chưa được định nghĩa

Triệu chứng

Quá trình biên dịch dừng lại với thông báo ! Undefined control sequence. Sau đó nhật ký hiện dòng nơi lỗi xảy ra, bị ngắt làm đôi: dòng trên là mọi thứ TeX đã đọc, tính đến và gồm cả lệnh gây lỗi, còn phần còn lại của dòng nguồn nằm ngay bên dưới. Token cuối cùng ở dòng trên là lệnh mà TeX không nhận ra, nên đây là một trong những lỗi dễ định vị chính xác nhất.

Vì sao lỗi này xảy ra

Chuỗi điều khiển là bất cứ thứ gì bắt đầu bằng dấu gạch chéo ngược. TeX không có bộ từ vựng cố định: các lệnh chỉ tồn tại vì nhân LaTeX, lớp tài liệu, một gói, hoặc \newcommand của chính bạn đã định nghĩa chúng. Khi TeX đọc một dấu gạch chéo ngược theo sau là một cái tên chưa ai định nghĩa, nó không thể đoán bạn muốn gì và dừng lại. Lỗi này không bao giờ nói rằng lệnh đó “sai” nói chung. Nó chỉ nói rằng cái tên ấy không được biết đến trong tài liệu này, tại điểm này, với engine này.

Sửa lỗi bằng ba bước kiểm tra

Hãy kiểm tra chính tả trước. \texbf thay vì \textbf, \lable thay vì \label, hay một khoảng trắng lọt vào làm tên lệnh bị tách đôi là nguyên nhân của phần lớn các trường hợp. Số dòng trong nhật ký đưa bạn thẳng đến chỗ gõ sai.

Nếu chính tả đúng, nhiều khả năng gói định nghĩa lệnh đó đang bị thiếu. \includegraphics không làm được gì nếu thiếu \usepackage{graphicx}, \toprule cần booktabs, và \SI cần siunitx. Lỗi này hay gặp nhất khi bạn chép một đoạn từ tài liệu khác hoặc từ câu trả lời của một mô hình: phần nội dung được chép theo, còn dòng khai báo gói ở preamble thì không. Hãy tìm gói nào định nghĩa lệnh trong Mọi lệnh trong thế giới LaTeX, được giải thích, thêm dòng \usepackage, rồi biên dịch lại. Nếu bản thân gói chưa được cài, xem Gói đó chưa được cài.

Nếu gói đã được nạp mà lỗi vẫn còn, hãy nghi ngờ engine. Một số lệnh chỉ tồn tại ở một engine nhất định: \fontspec và các lệnh cùng họ yêu cầu XeLaTeX hoặc LuaLaTeX, và sẽ chết với đúng lỗi này khi chạy dưới pdfLaTeX. Các mẫu ghi rõ engine trong tài liệu hướng dẫn thường làm vậy vì lý do này. Chọn engine nào cho dự án này giải thích các khác biệt.

Hai điểm đáng lưu ý

Thứ tự rất quan trọng: một lệnh được dùng trước dòng \usepackage định nghĩa nó vẫn chưa được định nghĩa tại điểm đó, vì vậy hãy giữ việc nạp gói ở preamble, phía trên \begin{document}. Và một lỗi thường che giấu lỗi khác, vì sau khi phục hồi, TeX có thể đọc sai mọi thứ phía sau. Hãy sửa chuỗi điều khiển chưa định nghĩa đầu tiên trong nhật ký, biên dịch lại, rồi mới xem những gì còn lại.

Quay lại Đọc hiểu nhật ký biên dịch