> 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/pl/pytania-i-odpowiedzi/81-tips-and-tricks-for-troubleshooting-latex.md).

# Wskazówki i triki do rozwiązywania problemów z LaTeX-em

Istnieje kilka wskazówek i trików, których możesz użyć, aby pomóc w identyfikacji i rozwiązywaniu problemów z LaTeX-em. Zwykle zalecamy debugowanie z włączonym [trybem kompilacji Zatrzymaj przy pierwszym błędzie](/latex/pl/baza-wiedzy/149-using-the-stop-on-first-error-compilation-mode.md), ponieważ pozwoli to uniknąć nagromadzenia błędów. Gdy napotkasz błąd, możesz wykonać następujące kroki, aby go rozwiązać:

1. **Czy występuje błąd lub ostrzeżenie?**

   Zacznij od spojrzenia na ikonę „Logi i pliki wyjściowe”, tuż na prawo od przycisku Ponowna kompilacja.

   ![Wskaźnik ostrzeżenia w ikonie „Logi i pliki wyjściowe”](/files/ce4f6f6c7cfa9c17df516fa49aff74387fd2bd9f)

   Komunikaty ostrzegawcze są wyświetlane na pomarańczowo. Często są to jedynie alerty, że LaTeX wykrył coś nietypowego i automatycznie wprowadził poprawki. Jeśli nie wpływają na końcowy wygląd dokumentu, zwykle można je zignorować.

   Na przykład wiele problemów z floatami oraz marginesami/odstępami jest korygowanych przez LaTeX bez potrzeby interwencji użytkownika. Overleaf zgłasza specjalną klasę ostrzeżeń, [ostrzeżenia o niedopełnionych i przepełnionych pudełkach](/latex/pl/baza-wiedzy/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors), na niebiesko — większość z nich można bezpiecznie zignorować, choć czasami wskazują fragment dokumentu, który trzeba sprawdzić.

   ![Wskaźnik błędu w ikonie „Logi i pliki wyjściowe”.](/files/e0f1f755b9b79ac02779fda98ee4e0a2d899a63a)

   Komunikaty błędów są wyświetlane na czerwono. Zwykle są bardziej problematyczne i mogą uniemożliwić poprawną kompilację dokumentu. Błędy krytyczne mogą całkowicie uniemożliwić kompilację dokumentu.

   Istnieje lista typowych błędów i sposobów ich rozwiązania [tutaj](/latex/pl/podstawy-latex-a/05-errors.md). Zalecamy poprawianie błędów tak szybko, jak to możliwe, ponieważ ich nagromadzenie może w przyszłości prowadzić do trudnych do zdiagnozowania i krytycznych błędów.
2. **Czy komunikat wskazuje na konkretny błąd lub numer wiersza?**

   ![Komunikat błędu zawierający numer wiersza.](/files/20cced4e69045c2e0b9a3ee6aa40afe146f8986b)

   W wielu przypadkach silnik LaTeX jest na tyle inteligentny, że potrafi określić dokładny błąd i podać numer wiersza. W powyższym przykładzie pojawił się symbol `_`, który w LaTeX-u trzeba poprzedzić znakiem ucieczki, tak jak tutaj: `\_`. Komunikat błędu wskazuje nawet, że błąd jest w wierszu 29, podświetla odpowiedni wiersz i pokazuje fragment tekstu, w którym znajduje się problem. Możesz kliknąć komunikat błędu, aby przejść bezpośrednio do pliku i numeru wiersza, w którym błąd występuje w kodzie źródłowym.

   Jeśli nie wskazano numeru wiersza, kontynuuj wypróbowywanie niektórych z poniższych kroków.
3. **Czy tekst błędu daje jakąś wskazówkę?**

   ![Komunikat błędu wskazujący, że problem dotyczy pliku .bbl, co sugeruje problem z bibliografią.](/files/4a7248f839471c5695a48d73f02f1ee704154a28)

   W powyższym komunikacie błędu podano numer wiersza, ale nie dla pliku, który zwykle edytujesz. Tutaj rozszerzenie pliku, .bbl, daje wskazówkę, że błąd uniemożliwiający kompilację jest problemem BibTeX.

   Wyszukanie wyróżnionego tekstu w pliku .bib pozwoli Ci znaleźć źródło błędu. Czasami [sprawdzenie plików pomocniczych i logów](/latex/pl/baza-wiedzy/150-view-generated-files.md) może ujawnić bardziej szczegółowe informacje niż krótsze okna komunikatów.
4. **Porównaj wcześniejsze wersje i wycofaj zmiany**

   Jeśli Twój projekt wcześniej kompilował się bez problemów, to prawdopodobnie w ostatnich edycjach wprowadziłeś do niego błąd. Możesz użyć [funkcji historii](/latex/pl/wiecej-tematow/49-using-the-history-feature.md) aby wycofać ostatnie zmiany.
5. **Spróbuj przenieść \end{document}**

   Jeśli nadal nie udało Ci się zawęzić lokalizacji błędu, wytnij `\end{document}` z samego końca głównego pliku .tex i spróbuj wklejać go w różnych częściach projektu. Zacznij od głównego pliku .tex, a następnie, jeśli to konieczne, od wszelkich plików podrzędnych, które wywołujesz w głównym pliku za pomocą `\input{}` lub `\include{}`. Postępuj metodycznie od samego końca projektu/dokumentu w kierunku początku dokumentu, powtarzając ten proces po jednej sekcji na raz. Zwróć szczególną uwagę na równania lub inne złożone sekcje podatne na drobne błędy.

   To powinno pomóc stopniowo zawężać dokument do coraz mniejszej części, aż uda się wyizolować sekcję zawierającą błąd. Jeśli dokument nagle zacznie się kompilować, będziesz wiedzieć, że znalazłeś błędną sekcję. W wielu przypadkach problem może być czymś tak prostym jak błędnie wpisane polecenie, niepoprzedzony znakiem ucieczki znak specjalny albo brakujący nawias.
6. **Czy to błąd kompilacji „limit czasu”?**

   W niektórych przypadkach użytkownicy mogą napotkać błędy kompilacji spowodowane przekroczeniem limitu czasu w określonych warunkach. Wynika to z limitów zasobów/czasu kompilacji na naszych serwerach. Mamy różne limity czasu dla kont darmowych i płatnych. Istnieje kilka wskazówek, które mamy, aby [przyspieszyć kompilację dokumentu](/latex/pl/baza-wiedzy/038-fixing-and-preventing-compile-timeouts.md), a jeśli to nie pomoże, skontaktuj się z nami, wysyłając [zgłoszenie do pomocy technicznej](https://www.overleaf.com/contact).
7. **Czy to błąd „renderowania PDF”?**

   Podobnie jak w przypadku innych usług online, czasami możesz napotkać problemy podczas korzystania z Overleaf. Stan przeglądarki, rozszerzenia przeglądarki, krótkie awarie u dostawców usług oraz problemy z konfiguracją sieci mogą potencjalnie powodować problemy.

   Jeśli masz problemy z połączeniem lub jeśli część edytora albo podglądu PDF nie ładuje się lub nie wyświetla zgodnie z oczekiwaniami, wypróbuj kroki rozwiązywania problemów na [tę stronę](/latex/pl/baza-wiedzy/125-resolving-access-loading-and-display-problems.md).
8. **Wypróbuj fora**

   Jeśli nie podano numeru wiersza i nie jesteś w stanie rozszyfrować podanego komunikatu błędu, szybka wyprawa metodą „kopiuj-wklej” do ulubionej wyszukiwarki może ujawnić informacje od doświadczonych użytkowników, którzy napotkali podobny problem. Do doskonałych forów związanych z TeX-em należą [LaTeX Stack Exchange](https://tex.stackexchange.com/) i [LaTeX Community](https://latex.org/forum/).
9. **Skontaktuj się z nami**

   Na koniec, ale nie mniej ważne, zawsze możesz wysłać nam [zgłoszenie do pomocy technicznej](https://www.overleaf.com/contact). Niezależnie od problemu, czy dotyczy on samego LaTeX-a, czy samej witryny, chętnie pomożemy Ci jak najlepiej wykorzystać korzystanie z 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/pl/pytania-i-odpowiedzi/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.