互相爭鬥的套件

hyperref 最後載入、cleveref 在其後、過時的套件組合、最小範例。

互相爭鬥的套件

LaTeX 套件可以自由地重新定義彼此的命令,而且許多套件是刻意這麼做的。hyperref 就是這樣把每個交互參照變成連結的。這也意味著兩個套件可能以不相容的假設各自修補同一個命令,結果從 Command \footnote already defined 或 Option clash for package xcolor 這類明顯錯誤,到默默出錯的輸出都有可能。在你把套件加進原本正常的前導碼之後,衝突幾乎總是立刻浮現,這也是最大的線索。

載入順序是成功的一半

許多衝突純粹是透過順序來解決的,因為後來載入的套件擁有最後的決定權。最重要的規則:在序言結尾附近載入hyperref。它重寫了 LaTeX 交互參照機制的大部分,並且在它之後加載的套件可能會撤消這些修補檔。一個簡短的例外清單必須稍後出現,而你實際遇到的例外是cleveref,它被設計為位於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 表示這個套件被以不同的選項載入了兩次,常常其中一次是你的文件類別背著你載入的。你不能帶著新選項再載入一次,但可以在任何人載入它之前注入選項:在 \documentclass 之前放 \PassOptionsToPackage{table}{xcolor},選項就會併入最先出現的那次載入。

用一個最小的例子來隔離

當原因不明顯時,建立一個最小工作範例:一份只包含 \documentclass、兩個可疑套件,以及一段只有一行文字之 \begin{document}...\end{document} 的文件。如果錯誤重現,就切換載入順序和選項,直到不再出現。如果沒有重現,就把其他套件分兩半加回去,直到錯誤回來。這種二分搜尋幾次編譯就會收斂,還給你一組明確可搜尋的關鍵字。同樣的技術也能拯救繼承而來的前導碼,如無法編譯的大學類別檔所述。

返回 執行環境