> 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/baza-wiedzy/149-using-the-stop-on-first-error-compilation-mode.md).

# Używanie trybu kompilacji Zatrzymaj przy pierwszym błędzie

Ten artykuł wyjaśnia, jak korzystać z trybu kompilacji Overleaf’s **Zatrzymaj przy pierwszym błędzie** wraz z omówieniem kilku ważnych zagadnień wprowadzających, w tym:

* Czym jest [tryb kompilacji LaTeX](#introduction-to-latex-errors-and-compilation)?
* [Tryby kompilacji w Overleaf](#compilation-modes-on-overleaf)
* Jak **Zatrzymaj przy pierwszym błędzie** może być [przydatne do debugowania](#benefits-of-using-the-stop-on-first-error-mode)

Aby pominąć informacje wprowadzające, możesz od razu przejść do sekcji wyjaśniającej [jak włączyć tryb kompilacji Zatrzymaj się przy pierwszym błędzie](#the-stop-on-first-error-compilation-mode).

## Wprowadzenie do błędów i kompilacji LaTeX

Konwersja dokumentu LaTeX do składanego pliku PDF jest wynikiem procesu zwanego *kompilacją*: wykonywalny program, znany jako „kompilator LaTeX”, odczytuje zawartość dokumentu i wykonuje jego składowe polecenia LaTeX, aby wygenerować składany plik PDF.

Podczas pisania znaczników LaTeX (kodu) zupełnie naturalne jest popełnianie błędów, które w trakcie kompilacji powodują, że kompilator wyświetla komunikaty o błędach próbujące wyjaśnić, co kompilator *uważa* jego zdaniem spowodowało problem(y). Podobnie jak w innych językach programowania, pojedynczy błąd w kodzie LaTeX dokumentu może wywołać lawinę błędów, każdy z odpowiadającym mu komunikatem. W Overleaf komunikaty o błędach kompilacji są zgłaszane użytkownikowi za pomocą [czerwonego powiadomienia obok **Ponowna kompilacja** przycisk](#overleafs-latex-error-reporting), a następnie możesz kliknąć **Dzienniki i pliki wyjściowe** ikonę, aby je zobaczyć.

### Obsługa błędów: tryby kompilacji

Kompilatory LaTeX, znane również jako [silniki TeX](/latex/pl/artykuly-szczegolowe/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), mają wbudowane (wybierane przez użytkownika) *tryby kompilacji* które określają sposób obsługi błędów. Poniższa lista punktowana używa własnej, opisowej nazwy Overleaf dla *własnej, opisowej nazwy* dla każdego z tych trybów:

* **Próbuj kompilować mimo błędów**—w istocie, nadal próbuj kompilować mimo napotykanych błędów, licząc na najlepszy wynik i być może generując plik PDF, który może jednak zawierać błędy składu.
* **Zatrzymaj przy pierwszym błędzie**—w praktyce „wycofaj się” przy pierwszym znaku problemu, wyświetl komunikat użytkownikowi i zakończ działanie bez tworzenia pliku PDF. Zapobiega to uruchomieniu późniejszej lawiny błędów, pozwalając skupić się na naprawieniu pierwszego błędu i ponownej kompilacji dokumentu.
* **Wstrzymaj kompilację, aby wejść w interakcję z użytkownikiem**—wstrzymaj kompilację, aby zaoferować pomoc i zapewnić mechanizmy umożliwiające użytkownikom naprawę błędów i kontynuowanie kompilacji. Jest to możliwe w lokalnej instalacji LaTeX, ale niepraktyczne w Overleaf.

## Tryby kompilacji w Overleaf

Aby zarządzać procesem kompilacji LaTeX, Overleaf używa [narzędzia budowania o nazwie latexmk](/latex/pl/baza-wiedzy/064-how-does-overleaf-compile-my-project.md) które domyślnie używa trybu kompilacji, który Overleaf nazywa **Próbuj kompilować mimo błędów:** narzędzie budowania będzie próbowało wygenerować składany plik PDF, nawet jeśli występują [błędy kompilacji LaTeX](/latex/pl/podstawy-latex-a/05-errors.md).

W **Próbuj kompilować mimo błędów** W tym trybie kompilacji kompilator LaTeX nie zatrzymuje się po wykryciu błędów; zamiast tego próbuje „zgadnąć” intencję użytkownika i stosuje „poprawki” na podstawie tego przypuszczenia — problematyczny kod może również zostać „pominięty”. Kompilator *może* powrócić do stanu, w którym proces kompilacji może ostatecznie się zakończyć i utworzyć plik PDF, choć wygenerowany PDF może zawierać nieprawidłowe wyniki. Często napotkane błędy mogą być zbyt poważne lub zbyt liczne, aby kompilator LaTeX mógł je naprawić, więc nadal może „wycofać się” bez wygenerowania pliku PDF.

### Zgłaszanie błędów LaTeX w Overleaf

Jak wspomniano powyżej, komunikaty o błędach generowane podczas kompilacji są zgłaszane użytkownikowi za pomocą czerwonego powiadomienia obok **Ponowna kompilacja** przycisku:

![Zrzut ekranu pokazujący błędy LaTeX zgłaszane w Overleaf](/files/b6a1b856c33db0dad6393a4a5143e102f1c66949)

Możesz kliknąć **Dzienniki i pliki wyjściowe** ikonę, aby wyświetlić więcej szczegółów dotyczących błędu/błędów. Na przykład, gdybyś omyłkowo wpisał `\texbf{word}` zamiast `\textbf{word}`, Overleaf nadal wyświetlałby podgląd skompilowanego pliku PDF wraz z komunikatem o błędzie dotyczącym niezdefiniowanej komendy, ale „word” nie byłoby pogrubione w pliku PDF!

## Tryb kompilacji Zatrzymaj się przy pierwszym błędzie

Użytkownicy mogą teraz zmienić tryb kompilacji LaTeX, przełączając się na **Zatrzymaj przy pierwszym błędzie** tryb, który powoduje, że Overleaf kończy kompilację natychmiast po wykryciu pierwszego błędu.

### Jak włączyć opcję Zatrzymaj się przy pierwszym błędzie

Wybierz mały trójkąt obok **Ponowna kompilacja** przycisku, a następnie wybierz **Zatrzymaj przy pierwszym błędzie** z **Ponowna kompilacja** menu rozwijanym:

![Zrzut ekranu pokazujący, jak włączyć tryb kompilacji „Zatrzymaj przy pierwszym błędzie”](/files/bd44de73fffc5285cb6e41b42181a496a2973dcd)

#### Zakres tego ustawienia trybu

Ta **Zatrzymaj przy pierwszym błędzie** tryb jest ustawieniem przypisanym do użytkownika i projektu. Włączenie tego trybu nie będzie *nie* miało wpływu na inne projekty ani na żadnych współpracowników w tym samym projekcie.

### Wyłączanie opcji Zatrzymaj się przy pierwszym błędzie

Gdy **Zatrzymaj przy pierwszym błędzie** jest włączona, możesz wrócić do domyślnego trybu kompilacji, wybierając niebieski przycisk **Wyłącz „Zatrzymaj się przy pierwszym błędzie”** znajdujący się w oknie dialogowym, które pojawia się, gdy wystąpi błąd kompilacji:

![Zrzut ekranu pokazujący komunikat o nieudanej kompilacji](/files/726e98a236790e6fa55c0a55e44aea4d497cdb6e)

Możesz też przejść do **Ponowna kompilacja** menu rozwijanego i wybrać **Próbuj kompilować mimo błędów** tryb:

![Zrzut ekranu pokazujący, jak wyłączyć tryb kompilacji Zatrzymaj się przy pierwszym błędzie](/files/156759267dfc46f82f0cf0f009e9c853b59ae822)

### Dodatkowe uwagi i porady

Jeśli Twój projekt nie zawiera błędów kompilacji LaTeX, podgląd PDF będzie wyświetlany jak zwykle. Jeśli Twój projekt *nie* zawiera błędy kompilacji LaTeX, kompilacja zatrzyma się natychmiast przy pierwszym błędzie. Pierwszy komunikat o błędzie jest wyświetlany, jak pokazano na poniższym zrzucie ekranu, abyś mógł skupić się na debugowaniu błędu w kodzie źródłowym. Na tym zrzucie ekranu błąd wynika z nieprawidłowego użycia `\caption{...}\label{...}` wewnątrz środowiska tabular. Linia 15 powinna zostać przeniesiona przed `\begin{tabular}`.

![Zrzut ekranu pokazujący typowy błąd LaTeX](/files/78bb3613099eb4646f8b7631f30acab2e3b20099)

Kliknij **Ponowna kompilacja** po naprawieniu każdego błędu, a następnie powtórz ten proces debugowania dla każdego kolejnego błędu kompilacji. Gdy Twój projekt nie zawiera już błędów LaTeX, **Zatrzymaj przy pierwszym błędzie** tryb wyświetli pomyślnie skompilowany plik PDF.

### Korzyści z używania trybu Zatrzymaj się przy pierwszym błędzie

* **Pomaga w debugowaniu przekroczeń czasu kompilacji.** Niektóre typy błędów kompilacji są tak poważne (np. przypadkowa rekurencja), że mogą zablokować **Próbuj kompilować mimo błędów** tryb kompilacji [przekroczenia czasu kompilacji](/latex/pl/baza-wiedzy/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) w projekcie Overleaf. Włączenie **Zatrzymaj przy pierwszym błędzie** tego trybu może pomóc zlokalizować i zdebugować takie błędy.
* **Nie pozwól, aby Twoje błędy się nawarstwiały.** Niektórzy użytkownicy mogą preferować zachowanie innych edytorów LaTeX, w których proces kompilacji zatrzymuje się przy pierwszym napotkanym błędzie LaTeX, dzięki czemu mogą go poprawić przed ponowną kompilacją. Zapobieganie kaskadzie błędów — wywołaniu lawiny kolejnych błędów — pozwala uniknąć konieczności debugowania ponad 100 komunikatów o błędach kompilacji, co może stać się trudne i dość żmudne.
* **Włączenie trybu Zatrzymaj się przy pierwszym błędzie może szybko wykryć Twoje błędy (jeśli jakieś są).** Jeśli masz duży lub złożony dokument, którego kompilacja trwa dłużej, **Próbuj kompilować mimo błędów** tryb wymaga czekania do zakończenia kompilacji. Jeśli występują błędy, które trzeba naprawić, oczekiwanie na pojawienie się pierwszego błędu kompilacji i możliwość jego poprawienia może być czasochłonne.
* **Nauka debugowania błędów jest istotną częścią nauki LaTeX.** Ta **Zatrzymaj przy pierwszym błędzie** tryb może pomóc początkującym użytkownikom LaTeX uczyć się i wcześnie wyrabiać dobre nawyki kodowania LaTeX, być może przyspieszając ich drogę do biegłości w LaTeX. Błędy LaTeX mogą wydawać się tak dziwne i ezoteryczne, że bardzo kusi, by je zignorować i pozwolić kompilatorowi działać dalej — licząc, że ostatecznie pojawi się plik PDF, nawet jeśli będzie zawierał błędy składu. W dłuższej perspektywie ignorowanie błędów kompilacji może prowadzić do złych nawyków kodowania, które ostatecznie mogą Cię później zaskoczyć, być może podczas przesyłania ważnego artykułu do czasopisma! Jeśli prowadzisz zajęcia z LaTeX, Twoi studenci mogą używać **Zatrzymaj przy pierwszym błędzie** trybu, aby rozwijać umiejętności debugowania błędów LaTeX.

## Błędy, które nie wydają się pochodzić z Twoich plików

Jeśli ręcznie zatrzymasz kompilację w **Próbuj kompilować mimo błędów** trybie, a następnie włączysz **Zatrzymaj przy pierwszym błędzie**, następna kompilacja może spowodować pojawienie się pozornie losowych komunikatów o błędach, takich jak `! Plik zakończył się podczas skanowania użycia \@writefile`, które nie wydają się pochodzić z Twoich plików. Takie błędy mogą wynikać z obciętych plików wygenerowanych przez poprzednią niepełną kompilację i pozostałych po niej. W takim przypadku możesz chcieć wykonać [Rekompiluj od zera](/latex/pl/baza-wiedzy/028-clearing-the-cache.md) tak aby następna kompilacja, nadal w **Zatrzymaj przy pierwszym błędzie** trybie, miała szansę rozpocząć się od czystego stanu i pokazać pierwszy istotny błąd. Jeśli nadal otrzymujesz błędy z pozornie nieistniejącego pliku — np. `output.aux`, `output.toc` itp. — zajrzyj na [tę stronę pomocy](/latex/pl/baza-wiedzy/066-how-to-find-and-fix-errors-reported-in-generated-files.md).

## Kilka szczegółów niskiego poziomu

Ta **Próbuj kompilować mimo błędów** tryb kompilacji uruchamia `latexmk` z następującymi flagami:

```latex
latexmk -f -interaction=nonstopmode …
```

Ta **Zatrzymaj przy pierwszym błędzie** tryb kompilacji uruchomi latexmk z następującymi flagami zamiast tego:

```latex
latexmk -halt-on-error -interaction=nonstopmode …
```

Skoro już tu jesteś, możesz być też zainteresowany przeczytaniem więcej o [tym, jak Overleaf używa `latexmk` narzędzia](/latex/pl/baza-wiedzy/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/pl/baza-wiedzy/149-using-the-stop-on-first-error-compilation-mode.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.