> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/es/base-de-conocimientos/149-using-the-stop-on-first-error-compilation-mode.md). # Usar el modo de compilación Detener en el primer error Este artículo explica cómo usar el **Detenerse en el primer error** modo de compilación de Overleaf, junto con la revisión de algunos temas de fondo importantes, incluidos: * ¿Qué es un [modo de compilación de LaTeX](#introduction-to-latex-errors-and-compilation)? * [Modos de compilación en Overleaf](#compilation-modes-on-overleaf) * Cómo **Detenerse en el primer error** puede ser [útil para depurar](#benefits-of-using-the-stop-on-first-error-mode) Si quieres omitir la información de fondo, puedes ir directamente a la sección que explica [cómo habilitar el modo de compilación Detenerse en el primer error](#the-stop-on-first-error-compilation-mode). ## Introducción a los errores de LaTeX y la compilación La conversión de un documento LaTeX en un archivo PDF maquetado es el resultado de un proceso llamado *compilación*: un programa ejecutable, conocido como “compilador de LaTeX”, lee el contenido de tu documento y ejecuta sus comandos LaTeX constituyentes para generar el archivo PDF maquetado. Al escribir marcado (código) LaTeX, es bastante natural cometer errores que, durante la compilación, hacen que el compilador emita mensajes de error que intentan explicar qué cree *cree* ha causado el/los problema(s). Como ocurre con otros lenguajes de programación, un solo error en el código LaTeX de tu documento puede desencadenar una cascada de errores, cada uno con su mensaje correspondiente. En Overleaf, los mensajes de error de compilación se informan al usuario mediante [una notificación roja junto al **Recompilar** botón](#overleafs-latex-error-reporting), y puedes hacer clic en el **panel de registros y archivos de salida** icono para verlos. ### Manejo de errores: modos de compilación Los compiladores de LaTeX, también conocidos como [motores TeX](/latex/es/articulos-en-profundidad/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), tienen *modos de compilación* integrados (seleccionables por el usuario) que determinan cómo se gestionan los errores. La siguiente lista con viñetas usa el propio nombre explicativo/descriptivo de Overleaf *propio nombre explicativo/descriptivo* para cada uno de esos modos: * **Intentar compilar a pesar de los errores**—en esencia, seguir intentando compilar a pesar de encontrar errores, con la esperanza de que todo salga bien, posiblemente produciendo un archivo PDF, pero uno que puede contener errores de maquetación. * **Detenerse en el primer error**—en la práctica, “abortar” ante la primera señal de problemas, mostrar un mensaje al usuario y salir sin crear un PDF. Esto evita desencadenar una cascada posterior de errores, permitiéndote centrarte en corregir el primer error y volver a compilar el documento. * **Suspender la compilación para interactuar con el usuario**—pausar la compilación para ofrecer ayuda y proporcionar mecanismos para que los usuarios corrijan errores y continúen la compilación. Esto es posible con una instalación local de LaTeX, pero poco práctico en Overleaf. ## Modos de compilación en Overleaf Para gestionar el proceso de compilación de LaTeX, Overleaf utiliza un [herramienta de compilación llamada latexmk](/latex/es/base-de-conocimientos/064-how-does-overleaf-compile-my-project.md) que, de forma predeterminada, usa un modo de compilación que Overleaf denomina **Intentar compilar a pesar de los errores:** la herramienta de compilación intentará producir un PDF maquetado, incluso si hay [errores de compilación de LaTeX](/latex/es/conceptos-basicos-de-latex/05-errors.md). En el **Intentar compilar a pesar de los errores** modo de compilación, el compilador de LaTeX no se detiene si se detectan errores; en su lugar, intenta “adivinar” la intención del usuario y aplica “correcciones” basadas en esa suposición; el código problemático también puede ser “omitido”. El compilador *podría* volver a un estado en el que el proceso de compilación pueda finalmente completarse para crear un PDF, aunque el PDF generado puede contener resultados incorrectos. A menudo, los errores encontrados pueden ser demasiado graves, o numerosos, para que el compilador de LaTeX los corrija, por lo que aun así podría “abortar” sin producir un PDF. ### La notificación de errores de LaTeX en Overleaf Como se señaló anteriormente, los mensajes de error generados durante la compilación se informan al usuario mediante una notificación roja junto al **Recompilar** botón: ![Captura de pantalla que muestra errores de LaTeX informados en Overleaf](/files/379f5802f8e96f2811a7d5d4f7655120c006a0dc) Puedes hacer clic en el **panel de registros y archivos de salida** icono para ver más detalles sobre el/los error(es). Por ejemplo, si hubieras escrito por error `\texbf{word}` en lugar de `\textbf{word}`, Overleaf seguiría mostrando una vista previa del PDF compilado junto con el mensaje de error sobre el comando indefinido, ¡pero “word” no estaría en negrita en el PDF! ## El modo de compilación Detenerse en el primer error Los usuarios ahora pueden cambiar el modo de compilación de LaTeX cambiando al **Detenerse en el primer error** modo que hace que Overleaf termine la compilación inmediatamente al detectar el primer error. ### Cómo habilitar Detenerse en el primer error Selecciona el pequeño triángulo junto al **Recompilar** botón y luego elige **Detenerse en el primer error** de **Recompilar** menú desplegable: ![Captura de pantalla que muestra cómo habilitar el modo de compilación Detenerse en el primer error](/files/369f232215da1e90cc647a975c3deb25f1bdd7f6) #### Alcance de esta configuración de modo El **Detenerse en el primer error** El modo es una configuración por usuario y por proyecto. Habilitar este modo *contiene* afectará a tus otros proyectos, o a cualquier colaborador en el mismo proyecto. ### Deshabilitar Detenerse en el primer error Cuando **Detenerse en el primer error** si está habilitado, puedes volver al modo de compilación predeterminado seleccionando el botón azul **Deshabilitar “Detenerse en el primer error”** ubicado en el cuadro de diálogo que aparece cuando hay un error de compilación: ![Captura de pantalla que muestra un mensaje de fallo de compilación](/files/3fbaaaf0f16190e48df7f996580d25eaf95f7186) También puedes ir al **Recompilar** menú desplegable y seleccionar el **Intentar compilar a pesar de los errores** modo: ![Captura de pantalla que muestra cómo deshabilitar el modo de compilación Detenerse en el primer error](/files/a42957971639274da207ed397a2605f2e3881771) ### Notas y consejos adicionales Si tu proyecto está libre de errores de compilación de LaTeX, se mostrará una vista previa del PDF como de costumbre. Si tu proyecto *no* contiene errores de compilación de LaTeX, la compilación se detendrá inmediatamente en el primer error. El primer mensaje de error se muestra como en la captura de pantalla a continuación, para que puedas concentrarte en depurar el error en tu código fuente. En esta captura de pantalla, el error se debe al uso incorrecto de `\caption{...}\label{...}` dentro de un entorno tabular. La línea 15 debería moverse antes de `\begin{tabular}`. ![Captura de pantalla que muestra un error típico de LaTeX](/files/b3e52435aba0c9a571f45766d106d12bf22fa006) Haz clic en **Recompilar** después de corregir cada error, y luego repite este proceso de depuración para cada error de compilación posterior. Cuando tu proyecto esté libre de errores de LaTeX, el **Detenerse en el primer error** modo mostrará el PDF compilado con éxito. ### Ventajas de usar el modo Detenerse en el primer error * **Ayuda a depurar los tiempos de espera de compilación.** Algunos tipos de errores de compilación son tan graves (por ejemplo, la recursión accidental) que pueden bloquear el **Intentar compilar a pesar de los errores** modo de compilación, lo que lleva a un [tiempo de espera de compilación](/latex/es/base-de-conocimientos/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) en un proyecto de Overleaf. Habilitar el **Detenerse en el primer error** modo puede ayudar a localizar y depurar tales errores. * **No dejes que tus errores se acumulen.** Algunos usuarios pueden preferir el comportamiento de otros editores de LaTeX en los que el proceso de compilación se detiene en el primer error de LaTeX encontrado para poder corregirlo antes de recompilar. Evitar que los errores se encadenen —desencadenando una avalancha de errores posteriores— evita tener que depurar más de 100 mensajes de error de compilación, lo que puede volverse difícil y algo tedioso. * **Habilitar el modo Detenerse en el primer error puede detectar rápidamente tus errores (si los hay).** Si tienes un documento grande o complejo que tarda más en compilar, el **Intentar compilar a pesar de los errores** modo requiere que esperes hasta que termine la compilación. Si hay errores que necesitas corregir, puede llevar tiempo tener que esperar antes de poder ver el primer error de compilación e intentar corregirlo. * **Aprender a depurar errores es una parte esencial de aprender LaTeX.** El **Detenerse en el primer error** modo puede ayudar a los principiantes de LaTeX a aprender y adoptar buenos hábitos de codificación en LaTeX desde el principio, quizás acelerando su camino hacia el dominio de LaTeX. Los errores de LaTeX pueden parecer tan extraños y esotéricos que resulta muy tentador ignorarlos y dejar que el compilador continúe —con la esperanza de que eventualmente aparezca un PDF, incluso si ese PDF contiene errores de maquetación. A largo plazo, ignorar los errores de compilación puede llevar a malos hábitos de codificación que podrían, eventualmente, pillarte por sorpresa en el futuro, ¡quizás durante el envío de un artículo importante a una revista! Si estás enseñando una clase sobre LaTeX, tus estudiantes pueden usar el **Detenerse en el primer error** modo para desarrollar habilidades para depurar errores de LaTeX. ## Errores que no parecen originarse en tus archivos Si detienes manualmente la compilación en el **Intentar compilar a pesar de los errores** modo, luego habilitas **Detenerse en el primer error**, la siguiente compilación puede dar lugar a algunos mensajes de error aparentemente aleatorios, como `! File ended while scanning use of \@writefile`, que no parecen originarse en tus archivos. Tales errores pueden deberse a archivos truncados generados por, y que quedaron de, la compilación incompleta anterior. En ese caso, es posible que quieras hacer un [Recompilar desde cero](/latex/es/base-de-conocimientos/028-clearing-the-cache.md) para que la siguiente compilación, aún en **Detenerse en el primer error** modo, tenga la oportunidad de comenzar desde cero y mostrar el primer error pertinente. Si sigues obteniendo errores de un archivo aparentemente inexistente —por ejemplo, `output.aux`, `output.toc` etc.— echa un vistazo a [esta página de ayuda](/latex/es/base-de-conocimientos/066-how-to-find-and-fix-errors-reported-in-generated-files.md). ## Algunos detalles de nivel inferior El **Intentar compilar a pesar de los errores** modo de compilación ejecuta `latexmk` con las siguientes opciones: ```latex latexmk -f -interaction=nonstopmode … ``` El **Detenerse en el primer error** modo de compilación ejecutará latexmk con las siguientes opciones en su lugar: ```latex latexmk -halt-on-error -interaction=nonstopmode … ``` Mientras estás aquí, también podría interesarte leer más sobre [cómo usa Overleaf la `latexmk` herramienta](/latex/es/base-de-conocimientos/064-how-does-overleaf-compile-my-project.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/es/base-de-conocimientos/149-using-the-stop-on-first-error-compilation-mode.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.