互いに衝突するパッケージ
hyperref は最後、cleveref はその後、廃止されたパッケージの組み合わせ、最小限の例。
互いに衝突するパッケージ
LaTeX のパッケージは、互いのコマンドを自由に再定義できます。意図的にそうしているパッケージも多く、hyperref がすべての相互参照をリンクに変えるのもその仕組みです。そのため、2 つのパッケージが同じコマンドに、互いに相容れない前提でパッチを当てることもあります。結果は、Command \footnote already defined や Option clash for package xcolor のようなはっきりしたエラーから、静かに出力が間違う場合まで、さまざまです。衝突はほとんどの場合、それまで動いていたプリアンブルにパッケージを追加した直後に表面化します。これが最大の手がかりでもあります。
読み込み順が戦いの半分
衝突の多くは、読み込み順を変えるだけで解決します。後から読み込まれたパッケージが優先されるためです。最も重要なルールは、hyperref をプリアンブルの終わり近くで読み込むことです。hyperref は LaTeX の相互参照の仕組みの大部分を書き換えるので、それより後に読み込まれたパッケージがそのパッチを元に戻してしまうことがあります。さらに後に置くべき例外が少数あり、実際に出会うのは cleveref です。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 は、同じパッケージが異なるオプションで 2 回読み込まれたことを意味します。多くの場合、片方はドキュメントクラスが裏で読み込んでいます。後から別のオプションで読み込み直すことはできませんが、誰かが読み込む前にオプションを渡しておくことはできます。\documentclass の前に \PassOptionsToPackage{table}{xcolor} を置くと、最初に行われた読み込みにオプションが統合されます。
最小限の例で切り分ける
原因がすぐに分からないときは、最小限の動く例を作ります。\documentclass、疑わしい 2 つのパッケージ、1 行のテキストを入れた \begin{document}...\end{document} だけの文書です。エラーが再現したら、消えるまで読み込み順とオプションを入れ替えます。再現しなければ、他のパッケージを半分ずつ戻していき、再現するところを探します。この二分探索は数回のコンパイルで収束し、調べるべき組み合わせがはっきりします。同じ手法は、引き継いだプリアンブルの立て直しにも使えます。詳しくは コンパイルが通らない大学のクラスファイル を参照してください。