> 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/it/base-di-conoscenza/149-using-the-stop-on-first-error-compilation-mode.md). # Usare la modalità di compilazione Ferma al primo errore Questo articolo spiega come usare la **Interrompi al primo errore** modalità di compilazione di Overleaf, insieme a una revisione di alcuni importanti argomenti di contesto, tra cui: * Che cos'è una [modalità di compilazione LaTeX](#introduction-to-latex-errors-and-compilation)? * [Modalità di compilazione su Overleaf](#compilation-modes-on-overleaf) * Come **Interrompi al primo errore** può essere [utile per il debug](#benefits-of-using-the-stop-on-first-error-mode) Per saltare le informazioni di contesto puoi andare direttamente alla sezione che spiega [come abilitare la modalità di compilazione Arresta al primo errore](#the-stop-on-first-error-compilation-mode). ## Introduzione agli errori LaTeX e alla compilazione La conversione di un documento LaTeX in un file PDF impaginato è il risultato di un processo chiamato *compilazione*: un programma eseguibile, noto come “compilatore LaTeX”, legge il contenuto del tuo documento ed esegue i suoi comandi LaTeX costitutivi per generare il file PDF impaginato. Quando si scrive markup LaTeX (codice) è del tutto naturale commettere errori che, durante la compilazione, causano la generazione di messaggi di errore da parte del compilatore che cercano di spiegare cosa il compilatore *pensa* ha causato il/i problema/i. Come per altri linguaggi di programmazione, un singolo errore nel codice LaTeX del tuo documento può innescare una cascata di errori, ognuno con il proprio messaggio. Su Overleaf, i messaggi di errore di compilazione vengono segnalati all'utente tramite [una notifica rossa accanto al **Ricompila** pulsante](#overleafs-latex-error-reporting), **Log e file di output** icona per visualizzarli. ### Gestire gli errori: modalità di compilazione I compilatori LaTeX, noti anche come [motori TeX](/latex/it/articoli-approfonditi/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), hanno modalità di compilazione *di compilazione* integrate (selezionabili dall'utente) che determinano come vengono gestiti gli errori. L'elenco puntato seguente usa il nome esplicativo/descrittivo di Overleaf *proprio esplicativo/descrittivo* per ciascuna di tali modalità: * **Prova a compilare nonostante gli errori**—in sostanza, continua a cercare di compilare nonostante l'incontro di errori, sperando per il meglio, eventualmente producendo un file PDF ma che potrebbe contenere errori di impaginazione. * **Interrompi al primo errore**—di fatto “abbandona” al primo segno di problemi, fornisce un messaggio all'utente ed esce senza creare un PDF. Questo evita di innescare una successiva cascata di errori, permettendoti di concentrarti sulla correzione del primissimo errore e ricompilare il documento. * **Sospendi la compilazione per interagire con l'utente**—mette in pausa la compilazione per offrire aiuto e fornire meccanismi che consentano agli utenti di correggere gli errori e continuare la compilazione. Ciò è possibile con un'installazione locale di LaTeX ma impraticabile su Overleaf. ## Modalità di compilazione su Overleaf Per gestire il processo di compilazione di LaTeX, Overleaf usa un [strumento di build chiamato latexmk](/latex/it/base-di-conoscenza/064-how-does-overleaf-compile-my-project.md) che, per impostazione predefinita, usa una modalità di compilazione che Overleaf definisce **Prova a compilare nonostante gli errori:** lo strumento di build cercherà di produrre un PDF impaginato, anche se ci sono [errori di compilazione LaTeX](/latex/it/concetti-di-base-di-latex/05-errors.md). Nella **Prova a compilare nonostante gli errori** in modalità di compilazione il compilatore LaTeX non si ferma se vengono rilevati errori; invece, tenta di “indovinare” al meglio l'intenzione dell'utente e applica “correzioni” basate su tale ipotesi—il codice problematico può anche essere “saltato”. Il compilatore *potrebbe* ritornare a uno stato in cui il processo di compilazione può eventualmente completarsi per creare un PDF, sebbene il PDF prodotto possa contenere output errato. Spesso, gli errori riscontrati possono essere troppo gravi, o numerosi, perché il compilatore LaTeX riesca a correggerli, quindi potrebbe comunque “abbandonare” senza produrre un PDF. ### La segnalazione degli errori LaTeX su Overleaf Come osservato sopra, i messaggi di errore generati durante la compilazione vengono segnalati all'utente tramite una notifica rossa accanto al **Ricompila** pulsante: ![Screenshot che mostra gli errori LaTeX segnalati su Overleaf](/files/88706bc73486251a80c8380d5f0a61dc05fc8c19) Puoi fare clic sull' **Log e file di output** icona per visualizzare maggiori dettagli sull'errore/gli errori. Ad esempio, se avessi digitato per errore `\texbf{word}` invece di `\textbf{word}`, Overleaf mostrerebbe comunque un'anteprima PDF compilata insieme al messaggio di errore sul comando non definito, ma “word” non sarebbe in grassetto nel PDF! ## La modalità di compilazione Arresta al primo errore Gli utenti possono ora modificare la modalità di compilazione LaTeX passando alla **Interrompi al primo errore** modalità che fa sì che Overleaf termini immediatamente la compilazione alla rilevazione del primo errore. ### Come abilitare Arresta al primo errore Seleziona il piccolo triangolo accanto al **Ricompila** pulsante, quindi scegli **Interrompi al primo errore** da **Ricompila** menu a discesa: ![Screenshot che mostra come abilitare la modalità di compilazione Interrompi al primo errore](/files/551618a9997518b88e245b8484cbb52231332ba2) #### Ambito di questa impostazione della modalità Il **Interrompi al primo errore** La modalità è un'impostazione per utente, per progetto. Abilitare questa modalità non *non* avrà effetti sugli altri tuoi progetti, né su eventuali collaboratori nello stesso progetto. ### Disabilitare Arresta al primo errore Quando **Interrompi al primo errore** è abilitata, puoi tornare alla modalità di compilazione predefinita selezionando il pulsante blu **Disabilita “Arresta al primo errore”** situato nella finestra di dialogo che appare quando c'è un errore di compilazione: ![Screenshot che mostra il messaggio di errore di compilazione](/files/ae7e1bb1aef921de955a000e508cda3b3e6e2a88) Puoi anche andare al **Ricompila** menu a discesa e selezionare la **Prova a compilare nonostante gli errori** modalità: ![Screenshot che mostra come disabilitare la modalità di compilazione Arresta al primo errore](/files/b2dcc20d513f52ca5caf5eabc14aa7865612f3ca) ### Note e consigli aggiuntivi Se il tuo progetto è privo di errori di compilazione LaTeX, verrà mostrata come di consueto un'anteprima PDF. Se il tuo progetto *di* contiene errori di compilazione LaTeX, la compilazione si fermerà immediatamente al primo errore. Il primo messaggio di errore viene visualizzato come mostrato nello screenshot qui sotto, così puoi concentrarti sul debug dell'errore nel tuo codice sorgente. In questo screenshot, l'errore è dovuto all'uso non corretto di `\caption{...}\label{...}` all'interno di un ambiente tabular. La riga 15 dovrebbe essere spostata prima di `\begin{tabular}`. ![Screenshot che mostra un tipico errore LaTeX](/files/89b0f9ddc3c9abaf1b0b6b7164b4148ce50aa624) Fai clic su **Ricompila** dopo aver corretto ciascun errore, e quindi ripeti questo processo di debug per ogni successivo errore di compilazione. Quando il tuo progetto è privo di errori LaTeX, la **Interrompi al primo errore** modalità mostrerà il PDF compilato con successo. ### Vantaggi dell'uso della modalità Arresta al primo errore * **Aiuta a fare il debug dei timeout di compilazione.** Alcuni tipi di errori di compilazione sono così gravi (ad es., la ricorsione accidentale) da poter bloccare la **Prova a compilare nonostante gli errori** modalità di compilazione, portando a un [timeout di compilazione](/latex/it/base-di-conoscenza/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) in un progetto Overleaf. Abilitare la **Interrompi al primo errore** modalità può aiutare a individuare e fare debug di tali errori. * **Non lasciare che i tuoi errori si accumulino.** Alcuni utenti potrebbero preferire il comportamento di altri editor LaTeX, in cui il processo di compilazione si fermerà al primo errore LaTeX incontrato, così da poter correggere l'errore prima di ricompilare. Impedire che gli errori si propaghino—innescando una valanga di ulteriori errori—evita di dover fare il debug di oltre 100 messaggi di errore di compilazione, che possono diventare difficili e un po' noiosi. * **Abilitare la modalità Arresta al primo errore può rilevare rapidamente i tuoi errori (se presenti).** Se hai un documento grande o complesso che richiede più tempo per compilare, la **Prova a compilare nonostante gli errori** modalità richiede che tu aspetti fino al termine della compilazione. Se ci sono errori che devi correggere, può richiedere molto tempo dover aspettare prima di poter vedere il primo errore di compilazione e provare a correggerlo. * **Imparare a fare debug degli errori è una parte essenziale dell'apprendimento di LaTeX.** Il **Interrompi al primo errore** modalità può aiutare i principianti di LaTeX a imparare e adottare fin dall'inizio buone abitudini di codifica LaTeX, forse accelerando il loro percorso verso la padronanza di LaTeX. Gli errori LaTeX possono sembrare così bizzarri ed esoterici che è molto forte la tentazione di ignorarli e lasciare che il compilatore continui—sperando che alla fine appaia un PDF, anche se quel PDF contiene errori di impaginazione. Nel lungo periodo, ignorare gli errori di compilazione può portare a cattive abitudini di codifica che potrebbero, alla fine, sorprenderti in futuro, magari durante la sottomissione di un importante articolo scientifico! Se stai tenendo un corso di LaTeX, i tuoi studenti possono usare la **Interrompi al primo errore** modalità per sviluppare competenze nel debug degli errori LaTeX. ## Errori che non sembrano sorgere all'interno dei tuoi file Se interrompi manualmente la compilazione nella **Prova a compilare nonostante gli errori** modalità, quindi abiliti **Interrompi al primo errore**, la compilazione successiva può produrre alcuni messaggi di errore apparentemente casuali, come `! Il file è terminato mentre si esaminava l'uso di \@writefile`, che non sembrano originare dai tuoi file. Tali errori potrebbero essere dovuti a file troncati generati da, e rimasti da, la precedente compilazione incompleta. In tal caso, potresti voler fare un [Ricompila da zero](/latex/it/base-di-conoscenza/028-clearing-the-cache.md) così che la successiva compilazione, ancora in **Interrompi al primo errore** modalità, abbia la possibilità di partire da zero e mostrare il primo errore pertinente. Se continui a ottenere errori da un file apparentemente inesistente—ad es., `output.aux`, `output.toc` ecc.—dai un'occhiata a [questa pagina di aiuto](/latex/it/base-di-conoscenza/066-how-to-find-and-fix-errors-reported-in-generated-files.md). ## Alcuni dettagli di livello inferiore Il **Prova a compilare nonostante gli errori** modalità di compilazione esegue `latexmk` con i seguenti flag: ```latex latexmk -f -interaction=nonstopmode … ``` Il **Interrompi al primo errore** la modalità di compilazione eseguirà invece latexmk con i seguenti flag: ```latex latexmk -halt-on-error -interaction=nonstopmode … ``` Già che ci sei, potresti essere interessato anche a leggere di più su [come Overleaf usa lo `latexmk` strumento](/latex/it/base-di-conoscenza/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/it/base-di-conoscenza/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.