无法编译的大学类文件

分类:第一个错误、引擎、过时的包、二分搜索。

无法编译的大学类文件

大学论文模板是一种特殊的遗留代码。一名研究生十五年前根据当时的 TeX 发行版编写了类文件,毕业后就把它冻结在原地,而 LaTeX 生态系统继续向前发展。当你今天下载 universitythesis.cls 却看到满屏错误时,这个类通常不是坏了,而是被时间搁浅了。不过,故障模式是可预测的,一套固定的排查顺序可以解决大多数问题。

仅从第一个错误开始

LaTeX 的失败会级联:类文件早期的一个未定义命令可能产生数十个毫无意义的下游错误。把日志滚动到第一行以 ! 开头的地方,修复它,然后在阅读其他内容之前重新编译。重复这个循环,通常三四个来回就能清掉一面令人生畏的错误墙。如果第一个错误是未知命令,未定义的控制序列 一文会带你完成诊断。

检查引擎

许多模板假设有一个特定的引擎,但在任何其他引擎下都会奇怪地失败。加载 fontspec 或按名称设置字体的类需要 XeLaTeX 或 LuaLaTeX;围绕pdftex特定原语构建的类可能会在这两种情况下失败。查找类文件顶部附近的注释或大学说明中命名预期引擎的一行,并在调试其他任何内容之前进行匹配。 该项目使用哪个引擎 中总结了这些差异。

实现你所控制的现代化

旧模板会加载过时的软件包,而这些软件包的现代替代品已经在你的发行版中,然后双方就会发生争执; 互相争斗的包列出了经典组合。可行的策略是保留类文件本身,因为大学的格式要求就在那里,并且只现代化你自己的序言:删除过时的\usepackage行,稍后加载hyperref,并避免重新加载类已经加载的任何内容。

对序言进行二分搜索

当错误无法通过观察定位时,注释掉序言的后半部分并重新编译。如果错误消失了,触发点就在被注释的那一半里;恢复其中一半再重复。几次编译就能把出错的那一行隔离出来,这比苦苦推理一个不是你写的序言快得多。

在受苦之前先搜索一下

那所大学的每个学生都编写相同的课程,因此几乎可以肯定你的错误以前已经遇到过。搜索确切的错误消息以及类文件的名称,并检查大学或后续学生是否在 GitHub 上维护已修补的分支。使用维护的分叉(如果存在)比你自己重新修复已知错误要好。

返回 长文