> 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/domande-e-risposte/81-tips-and-tricks-for-troubleshooting-latex.md).

# Suggerimenti e trucchi per la risoluzione dei problemi in LaTeX

Ci sono alcuni suggerimenti e trucchi che puoi usare per aiutarti a identificare e risolvere i problemi LaTeX. In generale consigliamo di eseguire il debug con il [la modalità di compilazione "Stop on First Error" attivata](/latex/it/base-di-conoscenza/149-using-the-stop-on-first-error-compilation-mode.md), poiché ti consentirà di evitare l'accumulo di errori. Una volta incontrato un errore, puoi seguire questi passaggi per risolverlo:

1. **C'è un errore o un avviso?**

   Inizia guardando l'icona "Log e file di output", appena a destra del pulsante Ricompila.

   ![Un indicatore di avviso nell'icona "Log e file di output"](/files/4a50ac269346830a593834ca9c8c4ea148b4ccff)

   I messaggi di avviso sono mostrati in arancione. Spesso sono solo avvisi che LaTeX ha trovato qualcosa di insolito e ha apportato regolazioni automatiche. Se non influiscono sull'aspetto finale del documento, di solito possono essere ignorati.

   Ad esempio, molti problemi di float e di margini/spazi vengono corretti da LaTeX senza bisogno di interventi dell'utente. Overleaf segnala una classe speciale di avvisi, [avvisi di box underfull e overfull](/latex/it/base-di-conoscenza/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors), in blu: la maggior parte può essere tranquillamente ignorata, anche se a volte evidenziano una parte del documento che deve essere controllata.

   ![Un indicatore di errore nell'icona "Log e file di output".](/files/bd1ad934e17ef04c18ca7805f35047914772fba4)

   I messaggi di errore sono mostrati in rosso. Di solito sono più problematici e possono impedire la corretta compilazione del documento. Gli errori fatali possono impedire del tutto la compilazione del documento.

   Esiste un elenco di errori comuni e di come risolverli [qui](/latex/it/concetti-di-base-di-latex/05-errors.md). Consigliamo di correggere gli errori il prima possibile, poiché lasciarli accumulare può portare in futuro a errori difficili da debuggare e fatali.
2. **Il messaggio indica un errore specifico o un numero di riga?**

   ![Un messaggio di errore che include un numero di riga.](/files/8604a110ac2831dd62efacc6413668bd7f3f192a)

   In molti casi, il motore LaTeX è abbastanza intelligente da capire l'errore esatto e fornirti un numero di riga. Nell'esempio sopra, c'era il simbolo `_`, che LaTeX richiede di essere escapato in questo modo: `\_`. Il messaggio di errore indica persino che l'errore è alla riga 29, evidenzia la riga appropriata e mostra un estratto del testo in cui si trova il problema. Puoi fare clic sul messaggio di errore per passare direttamente al file e al numero di riga in cui l'errore si verifica nel codice sorgente.

   Se non è indicato alcun numero di riga, continua a provare alcuni dei passaggi seguenti.
3. **Il testo dell'errore fornisce un indizio?**

   ![Un messaggio di errore che indica che il problema è nel file .bbl, suggerendo un problema con la bibliografia.](/files/e5c405ee5ae18f133f122ae0be4d5b0d168625c7)

   Nel messaggio di errore sopra, viene fornito un numero di riga, ma non per un file che di solito modifichi. Qui, l'estensione del file, .bbl, fornisce un indizio che l'errore che impedisce la compilazione è un problema di BibTeX.

   La ricerca del testo evidenziato nel tuo file .bib ti permetterà di trovare l'origine dell'errore. A volte [il controllo dei file ausiliari e dei log](/latex/it/base-di-conoscenza/150-view-generated-files.md) può rivelare informazioni più specifiche rispetto ai messaggi di dialogo più brevi.
4. **Confronta le versioni precedenti e ripristina le modifiche**

   Se in precedenza il tuo progetto compilava senza problemi, allora probabilmente hai introdotto un errore nel progetto nelle modifiche recenti. Puoi usare la [funzione Cronologia](/latex/it/altri-argomenti/49-using-the-history-feature.md) per ripristinare le modifiche recenti.
5. **Prova a spostare \end{document}**

   Se ancora non sei riuscito a circoscrivere la posizione dell'errore, ritaglia il `\end{document}` dalla fine del tuo file .tex principale e prova a incollarlo in varie parti del progetto. Inizia con il file .tex principale e poi, se necessario, con eventuali sottofile che richiami nel file principale con `\input{}` o `\include{}`. Procedi in modo metodico dalla fine del progetto/documento verso l'inizio del documento, ripetendo questo processo una sezione alla volta. Presta particolare attenzione alle equazioni o ad altre sezioni complesse soggette a piccoli errori.

   Questo dovrebbe aiutarti a restringere progressivamente il documento a un documento sempre più piccolo finché non riesci a isolare la sezione contenente l'errore. Se il documento inizia improvvisamente a compilarsi, sai di aver individuato la sezione errata. In molti casi, il problema potrebbe essere qualcosa di semplice come un comando digitato male, un carattere speciale non escapato o una parentesi mancante.
6. **Si tratta di un errore di compilazione "timeout"?**

   In alcuni casi, gli utenti possono incontrare errori di compilazione per timeout in determinate condizioni. Ciò è dovuto ai limiti di tempo/risorse sui nostri server. Abbiamo diversi limiti di tempo per gli account gratuiti e per quelli a pagamento. Ci sono diversi suggerimenti che abbiamo per [rendere il tuo documento più veloce da compilare](/latex/it/base-di-conoscenza/038-fixing-and-preventing-compile-timeouts.md), e se questi non funzionano, non esitare a contattarci con una [richiesta di supporto](https://www.overleaf.com/contact).
7. **Si tratta di un errore di "rendering del PDF"?**

   Come per altri servizi online, a volte potresti incontrare problemi durante l'uso di Overleaf. Lo stato del browser, le estensioni del browser, brevi interruzioni dei provider di servizi e problemi di configurazione della rete possono potenzialmente causare problemi.

   Se hai problemi di connessione, o se una parte dell'editor o del visualizzatore PDF non si carica o non viene visualizzata come previsto, prova le procedure di risoluzione dei problemi su [questa pagina](/latex/it/base-di-conoscenza/125-resolving-access-loading-and-display-problems.md).
8. **Prova i forum**

   Se non viene fornito alcun numero di riga e non riesci a decifrare il messaggio di errore fornito, un rapido "copia-incolla" sul tuo motore di ricerca preferito potrebbe rivelare informazioni di utenti esperti che hanno affrontato un problema simile. Alcuni eccellenti forum relativi a TeX includono [LaTeX Stack Exchange](https://tex.stackexchange.com/) e [LaTeX Community](https://latex.org/forum/).
9. **Contattaci**

   Infine, ma non meno importante, puoi sempre inviarci un [richiesta di supporto](https://www.overleaf.com/contact). Qualunque sia il tuo problema, che sia specifico a LaTeX o al sito, saremo felici di aiutarti a ottenere il massimo dalla tua esperienza con Overleaf.


---

# 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/domande-e-risposte/81-tips-and-tricks-for-troubleshooting-latex.md?ask=<question>&goal=<endgoal>
```

`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.