緊急停止與失控參數

缺少結尾、大括號或錯誤的引入所造成的致命中止。

緊急停止與失控參數

症狀

編譯直接中止。記錄檔以 ! Emergency stop. 結尾,或顯示 Runaway argument?,後面跟著一長段你自己的文字,通常還伴隨一行像 File ended while scanning use of \textbf 或 Paragraph ended before \foo was complete 這樣的訊息。與大多數 LaTeX 錯誤不同,這次完全沒有 PDF,而且回報的行號常指向檔案結尾,而非真正出錯的地方。

為什麼會發生

兩個訊息都源自同一個問題:TeX 開始讀取某個必須被封閉的東西,卻在封閉記號出現之前就讀到了輸入的盡頭。當你寫 \textbf{ 時,TeX 會把直到對應 } 為止的所有內容收集成參數。如果那個大括號一直沒有出現,TeX 就會不斷吞下文字,越過段落和小節,直到檔案用完。「Runaway argument」是 TeX 把它吞下的東西給你看;「Emergency stop」是 TeX 放棄,因為少了那一塊它無法繼續。缺少 \end{document}、未封閉的環境,或 \input 一個不存在的檔案,都會造成同樣的終局。

如何找到真正的位置

不要相信行號;它標記的是 TeX 用完輸入的位置,不是失衡開始的位置。去讀記錄檔裡的 Runaway argument? 區塊。被吞下文字的開頭幾個字會告訴你失控是從文件哪裡開始的,而 File ended while scanning use of ... 那一行則指出哪個命令的參數沒有被封閉。在引文附近搜尋那個命令,數一數它的大括號。

如果記錄檔幫不上忙,就對文件做二分搜尋。把正文的後半部註解掉(或包在 \iffalse ... \fi 裡)再重新編譯。如果錯誤消失了,問題就在你移開的那一半;持續對半切,直到隔離出有問題的段落。這聽起來很粗糙,但在大型文件上,幾次編譯就能找到一個遺漏的大括號。

常見的肇因

檢查粗體、斜體、腳註和圖表標題附近是否有少了 } 的 {,因為這些命令的參數大括號是你親手打的。檢查每個 \begin{...} 都有一個環境名稱相同的 \end{...} 與之對應。確認檔案以 \end{document} 結尾,而且每個 \input 和 \include 都指向該路徑上確實存在的檔案。編輯器在這裡幫得上忙:Oleafly 會在你輸入時標示成對的大括號和環境,大部分問題在編譯器看到之前就被攔下了。

返回 日誌讀寫能力