互相冲突的包

hyperref 放最后,cleveref 跟其后,过时包的组合,最小示例。

互相冲突的包

LaTeX 包可以随意重定义彼此的命令,许多包也正是故意这么做的。hyperref 把每个交叉引用变成链接,靠的就是这一点。这同样意味着,两个包可能带着互不兼容的假设去修补同一条命令,结果轻则出现 Command \footnote already defined 或 Option clash for package xcolor 这样的直接错误,重则得到悄悄出错的输出。冲突几乎总是在你往一个原本正常的导言区里添加包之后立刻出现,而这本身也是最大的线索。

加载顺序成功了一半

许多冲突单靠顺序就能解决,因为后加载的包拥有最后发言权。最重要的规则:把 hyperref 加载在导言区末尾附近。它重写了 LaTeX 交叉引用机制的大部分,在它之后加载的包可能破坏这些补丁。少数例外必须加载得更晚,你真正会遇到的是 cleveref:它设计在 hyperref 之上工作,必须加载在 hyperref 之后:

\usepackage{graphicx}
\usepackage{amsmath}
% ... everything else ...
\usepackage{hyperref}
\usepackage{cleveref} % after hyperref, by design

当一个包的文档写明了它相对另一个包的位置时,请相信它。这些备注的存在,是因为已经有人撞上了你即将撞上的冲突。

过时的包及其替代品

有些冲突来自把一个已被淘汰的包和它的继任者加载在一起。不要把 epsfig 与 graphicx、subfigure 与 subcaption 组合,也不要把旧的 times 和 mathptmx 过渡包与 newtxtext 这样的现代字体包放在一起。旧模板是常见的来源:它们加载的是模板编写当时流行的包,而你又在上面叠加了现代等价物。移除过时的那个,保留替代品。nag 包可以在编译时为你标出过时的用法。

选项冲突

Option clash for package X 的意思是这个包被以不同的选项加载了两次,其中一次常常是你的文档类在背后偷偷干的。你不能带着新选项再加载它一次,但可以在任何人加载它之前注入选项:把 \PassOptionsToPackage{table}{xcolor} 放在 \documentclass 之前,这些选项就会并入最先到来的那次加载。

用最小示例隔离问题

当原因不明显时,构造一个最小工作示例:一个只含 \documentclass、两个嫌疑包、以及 \begin{document}...\end{document} 内一行文字的文档。如果错误复现,就反复调整加载顺序和选项直到它消失。如果没有复现,就把其余的包分两半逐步加回来,直到错误重现。这种二分搜索几次编译就能收敛,还给你留下一对明确的包名去搜索。同样的技术也能抢救继承来的导言区,见无法编译的大学文档类文件。

返回 运行时