紧急停止与失控参数

缺少结尾、花括号或错误的文件包含导致的致命中止。

紧急停止与失控参数

症状

编译直接中止。日志以 ! 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 会在你键入时高亮匹配的花括号和环境对,在编译器见到问题之前就拦下其中大部分。

返回 日志素养