互相爭鬥的套件
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} 的文件。如果錯誤重現,就切換載入順序和選項,直到不再出現。如果沒有重現,就把其他套件分兩半加回去,直到錯誤回來。這種二分搜尋幾次編譯就會收斂,還給你一組明確可搜尋的關鍵字。同樣的技術也能拯救繼承而來的前導碼,如無法編譯的大學類別檔所述。