Paquetes que se pelean entre sí

hyperref al final, cleveref después, pares obsoletos y ejemplos mínimos.

Paquetes que se pelean entre sí

Los paquetes de LaTeX pueden redefinir los comandos de otros, y muchos lo hacen a propósito. Así es como hyperref convierte cada referencia cruzada en un enlace. También significa que dos paquetes pueden parchear el mismo comando con supuestos incompatibles, y el resultado va desde un error declarado, como Command \footnote already defined u Option clash for package xcolor, hasta una salida que es incorrecta sin avisar. Los conflictos casi siempre aparecen justo después de añadir un paquete a un preámbulo que antes funcionaba, y esa es también la mayor pista.

El orden de carga es la mitad de la batalla

Muchos conflictos se resuelven solo con el orden, porque el paquete que se carga después tiene la última palabra. La regla más importante: carga hyperref casi al final del preámbulo. Reescribe buena parte de la maquinaria de referencias cruzadas de LaTeX, y los paquetes que se cargan después pueden deshacer esos parches. Una lista corta de excepciones debe cargarse todavía más tarde, y la que te encontrarás de verdad es cleveref, que está diseñado para ir encima de hyperref y debe cargarse después de él:

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

Cuando la documentación de un paquete indica su posición respecto a otro, hazle caso. Esas notas existen porque alguien ya tuvo el conflicto que estás a punto de tener.

Paquetes obsoletos y sus sustitutos

Algunos conflictos vienen de cargar un paquete muerto junto a su sucesor. No combines epsfig con graphicx, subfigure con subcaption, ni los antiguos parches de compatibilidad times y mathptmx con paquetes de fuentes modernos como newtxtext. Las plantillas antiguas suelen ser el origen: cargan lo que estaba vigente cuando se escribieron, y tú añades encima el equivalente moderno. Quita el obsoleto y quédate con el sustituto. El paquete nag puede avisarte de usos anticuados durante la compilación.

Conflictos de opciones

Option clash for package X significa que el paquete se cargó dos veces con opciones distintas, a menudo una de ellas por la clase del documento sin que lo sepas. No puedes cargarlo otra vez con opciones nuevas, pero sí puedes inyectar opciones antes de que nadie lo cargue: escribe \PassOptionsToPackage{table}{xcolor} antes de \documentclass, y las opciones se combinan con la primera carga que ocurra.

Aísla el problema con un ejemplo mínimo

Cuando la causa no es evidente, crea un ejemplo mínimo que funcione: un documento que contenga solo \documentclass, los dos paquetes sospechosos y un \begin{document}...\end{document} con una línea de texto. Si el error se reproduce, cambia el orden de carga y las opciones hasta que desaparezca. Si no se reproduce, vuelve a añadir tus otros paquetes por mitades hasta que reaparezca. Esta búsqueda binaria converge en pocas compilaciones y te da un par claro por el que buscar. La misma técnica rescata preámbulos heredados, como se describe en Clases universitarias que no compilan.

Volver a Tiempo de ejecución