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

# 첫 번째 오류에서 중지 컴파일 모드 사용하기

이 글에서는 Overleaf의 **첫 오류에서 중지** 컴파일 모드와 함께 다음과 같은 중요한 배경 주제를 살펴봅니다:

* 무엇인가 [LaTeX 컴파일 모드](#introduction-to-latex-errors-and-compilation)?
* [Overleaf의 컴파일 모드](#compilation-modes-on-overleaf)
* 어떻게 **첫 오류에서 중지** 다음이 될 수 있습니다 [디버깅에 유용한](#benefits-of-using-the-stop-on-first-error-mode)

배경 설명을 건너뛰려면 다음을 설명하는 섹션으로 바로 이동할 수 있습니다: [첫 번째 오류에서 중지 컴파일 모드를 활성화하는 방법](#the-stop-on-first-error-compilation-mode).

## LaTeX 오류와 컴파일 소개

LaTeX 문서를 조판된 PDF 파일로 변환하는 것은 다음과 같은 과정의 결과입니다 *컴파일*: ‘LaTeX 컴파일러’로 알려진 실행 가능한 프로그램이 문서의 내용을 읽고, 그 안의 LaTeX 명령을 실행하여 조판된 PDF 파일을 생성합니다.

LaTeX 마크업(코드)을 작성할 때 실수를 하는 것은 매우 자연스러운 일이며, 컴파일 중에는 컴파일러가 오류 메시지를 내보내게 되어 그 메시지는 컴파일러가 무엇이 *원인이라고 생각하는지* 문제를 일으켰는지 설명하려고 합니다. 다른 프로그래밍 언어와 마찬가지로, 문서의 LaTeX 코드에 있는 단 하나의 실수도 연쇄적인 오류를 유발할 수 있으며, 각각에 해당하는 메시지가 표시됩니다. Overleaf에서는 컴파일 오류 메시지가 사용자에게 다음을 통해 보고됩니다 [다음 옆의 빨간 알림 **다시 컴파일** 버튼을 클릭하세요](#overleafs-latex-error-reporting), 그리고 다음을 클릭하면 **로그 및 출력 파일** 아이콘에서 확인할 수 있습니다.

### 오류 처리: 컴파일 모드

LaTeX 컴파일러는 다음으로도 알려져 있으며 [TeX 엔진](/latex/ko/in-depth-articles/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), 내장된(사용자가 선택할 수 있는) *컴파일 모드* 가 있으며, 이는 오류를 어떻게 처리할지 결정합니다. 다음 글머리 목록에서는 Overleaf의 *고유한 설명/서술형 이름* 을 각 모드에 사용합니다:

* **오류가 있어도 컴파일 시도**—기본적으로 오류를 만나더라도 계속 컴파일을 시도하며, 최선의 결과를 기대합니다. PDF 파일이 생성될 수도 있지만 조판 오류를 포함할 수 있습니다.
* **첫 오류에서 중지**—문제가 보이는 즉시 사실상 ‘중단’하고 사용자에게 메시지를 표시한 뒤 PDF를 만들지 않고 종료합니다. 이렇게 하면 이후의 연쇄 오류를 피할 수 있어, 가장 처음의 오류를 수정하고 문서를 다시 컴파일하는 데 집중할 수 있습니다.
* **사용자와 상호작용하기 위해 컴파일 일시 중지**—컴파일을 일시 중지하여 도움을 제공하고 사용자가 오류를 수정한 뒤 컴파일을 계속할 수 있는 방법을 제공합니다. 이는 로컬 LaTeX 설치에서는 가능하지만 Overleaf에서는 실용적이지 않습니다.

## Overleaf의 컴파일 모드

LaTeX의 컴파일 과정을 관리하기 위해 Overleaf는 다음을 사용합니다 [latexmk라는 빌드 도구](/latex/ko/knowledge-base/064-how-does-overleaf-compile-my-project.md) 이며, 기본적으로 Overleaf가 다음과 같이 부르는 컴파일 모드를 사용합니다 **오류가 있어도 컴파일 시도:** 빌드 도구는 다음이 있더라도 조판된 PDF를 만들려고 시도합니다 [LaTeX 컴파일 오류](/latex/ko/latex/05-errors.md).

다음에서 **오류가 있어도 컴파일 시도** 컴파일 모드에서는 오류가 감지되어도 LaTeX 컴파일러가 멈추지 않습니다. 대신 사용자의 의도를 ‘최선으로 추정’하여 그 추정에 따라 ‘수정’을 적용하며, 문제가 있는 코드가 ‘건너뛰어질’ 수도 있습니다. 컴파일러는 *때로는* 컴파일 과정이 결국 완료되어 PDF를 만들 수 있는 상태로 돌아갈 수도 있지만, 생성된 PDF에는 잘못된 출력이 포함될 수 있습니다. 종종 발생한 오류가 너무 심각하거나 너무 많아서 LaTeX 컴파일러가 수정할 수 없으므로, PDF를 만들지 못한 채 여전히 ‘중단’할 수도 있습니다.

### Overleaf의 LaTeX 오류 보고

위에서 언급했듯이, 컴파일 중 생성된 오류 메시지는 다음 옆의 빨간 알림을 통해 사용자에게 보고됩니다 **다시 컴파일** 버튼:

![Overleaf에 보고된 LaTeX 오류를 보여주는 스크린샷](/files/bb8c118750795812cefb517e8745e82add8d420f)

다음을 클릭하면 **로그 및 출력 파일** 아이콘에서 오류에 대한 자세한 내용을 볼 수 있습니다. 예를 들어, 실수로 다음을 입력했다면 `\texbf{word}` 대신 `\textbf{word}`, Overleaf는 정의되지 않은 명령에 대한 오류 메시지와 함께 컴파일된 PDF 미리보기를 계속 보여주지만, PDF에서 “word”는 굵게 표시되지 않습니다!

## 첫 번째 오류에서 중지 컴파일 모드

이제 사용자는 다음으로 전환하여 LaTeX 컴파일 모드를 변경할 수 있습니다 **첫 오류에서 중지** 이 모드는 첫 번째 오류가 감지되면 Overleaf가 즉시 컴파일을 종료하게 합니다.

### 첫 번째 오류에서 중지를 활성화하는 방법

다음 옆의 작은 삼각형을 선택한 다음 **다시 컴파일** 버튼을 선택한 뒤 다음을 선택합니다 **첫 오류에서 중지** 에서 **다시 컴파일** 드롭다운 메뉴:

![첫 오류에서 중지 컴파일 모드를 활성화하는 방법을 보여 주는 스크린샷](/files/0d95a01bb5942028ad69ae9a1c5e58915fb92365)

#### 이 모드 설정의 범위

다음 **첫 오류에서 중지** 모드는 사용자별, 프로젝트별 설정입니다. 이 모드를 활성화하면 *작동하지* 다른 프로젝트나 같은 프로젝트의 공동 작업자에게는 영향을 주지 않습니다.

### 첫 번째 오류에서 중지 비활성화

언제 **첫 오류에서 중지** 가 활성화되어 있으면 파란색 버튼을 선택하여 기본 컴파일 모드로 다시 전환할 수 있습니다 **‘첫 번째 오류에서 중지’ 비활성화** 컴파일 오류가 있을 때 나타나는 대화 상자에 있습니다:

![컴파일 실패 메시지를 보여주는 스크린샷](/files/9a301e660934fbc04815f7b024ea66e85baeed10)

또한 다음으로 이동한 뒤 **다시 컴파일** 드롭다운 메뉴에서 다음을 선택할 수 있습니다 **오류가 있어도 컴파일 시도** 모드:

![첫 번째 오류에서 중지 컴파일 모드를 비활성화하는 방법을 보여주는 스크린샷](/files/a7f226f5bee4777944138dd1df0cccd1e7cc2110)

### 추가 참고 사항 및 조언

프로젝트에 LaTeX 컴파일 오류가 없으면 평소처럼 PDF 미리보기가 표시됩니다. 프로젝트에 *실제로* LaTeX 컴파일 오류가 포함되어 있으면 컴파일은 첫 번째 오류에서 즉시 중지됩니다. 첫 번째 오류 메시지는 아래 스크린샷에 보이듯이 표시되므로 소스 코드의 오류 디버깅에 집중할 수 있습니다. 이 스크린샷에서 오류는 다음을 잘못 사용했기 때문입니다 `\caption{...}\label{...}` tabular 환경 내부에 있습니다. 15행은 다음 앞쪽으로 옮겨야 합니다 `\begin{tabular}`.

![일반적인 LaTeX 오류를 보여주는 스크린샷](/files/0fb8d60d533a38543457ff27813a335a92b802e7)

다음을 클릭한 뒤 **다시 컴파일** 각 오류를 수정한 후, 이후의 각 컴파일 오류에 대해 이 디버깅 과정을 반복합니다. 프로젝트에 LaTeX 오류가 없으면 **첫 오류에서 중지** 모드에서 성공적으로 컴파일된 PDF가 표시됩니다.

### 첫 번째 오류에서 중지 모드를 사용하는 이점

* **컴파일 시간 초과 디버깅에 도움이 됩니다.** 어떤 종류의 컴파일 오류는 매우 심각해서(예: 의도치 않은 재귀) 다음을 막을 수 있습니다 **오류가 있어도 컴파일 시도** 컴파일 모드로 이어져 [컴파일 시간 초과](/latex/ko/knowledge-base/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) 를 Overleaf 프로젝트에서 초래할 수 있습니다. 다음을 활성화하면 **첫 오류에서 중지** 모드가 이러한 오류를 찾고 디버깅하는 데 도움이 될 수 있습니다.
* **오류를 쌓아 두지 마세요.** 일부 사용자는 다른 LaTeX 편집기처럼 컴파일 과정이 처음 만난 LaTeX 오류에서 멈추는 동작을 선호할 수 있습니다. 그러면 다시 컴파일하기 전에 오류를 수정할 수 있습니다. 오류가 연쇄적으로 번지는 것—더 많은 오류의 쇄도를 유발하는 것—을 막으면 100개가 넘는 컴파일 오류 메시지를 디버깅해야 하는 상황을 피할 수 있으며, 이는 어렵고 다소 지루할 수 있습니다.
* **첫 번째 오류에서 중지 모드를 활성화하면 오류가 있다면 빠르게 감지할 수 있습니다.** 컴파일하는 데 시간이 더 걸리는 크거나 복잡한 문서가 있다면 **오류가 있어도 컴파일 시도** 모드에서는 컴파일이 끝날 때까지 기다려야 합니다. 수정해야 할 오류가 있다면 첫 번째 컴파일 오류를 보기 전까지 기다려야 하므로 시간이 많이 걸릴 수 있습니다.
* **오류를 디버깅하는 법을 배우는 것은 LaTeX를 배우는 데 필수적인 부분입니다.** 다음 **첫 오류에서 중지** 모드는 LaTeX 초보자가 초기에 좋은 LaTeX 코딩 습관을 배우고 받아들이는 데 도움이 될 수 있으며, LaTeX 숙련으로 가는 여정을 더 빠르게 해줄지도 모릅니다. LaTeX 오류는 너무 이상하고 난해해 보여서 무시하고 컴파일러가 계속 진행하도록 두고 싶은 유혹이 큽니다. PDF에 조판 오류가 있더라도 결국 PDF가 나타나기를 바라면서 말이죠. 장기적으로 보면 컴파일 오류를 무시하는 습관은 나쁜 코딩 습관으로 이어질 수 있고, 결국 나중에 특히 중요한 학술지 논문을 제출할 때 발목을 잡을 수 있습니다! LaTeX 수업을 가르치고 있다면 학생들은 다음을 사용하여 **첫 오류에서 중지** 모드를 사용해 LaTeX 오류 디버깅 기술을 기를 수 있습니다.

## 파일 내에서 발생한 것처럼 보이지 않는 오류

다음에서 컴파일을 수동으로 중지한 뒤 **오류가 있어도 컴파일 시도** 모드를 사용하고 나서 다음을 활성화하면 **첫 오류에서 중지**, 다음 컴파일에서는 다음과 같은 겉보기에는 무작위인 오류 메시지가 나타날 수 있습니다 `! File ended while scanning use of \@writefile`, 이는 파일 내부에서 비롯된 것처럼 보이지 않습니다. 이러한 오류는 이전의 불완전한 컴파일에서 생성되어 남아 있는 잘린 파일 때문일 수 있습니다. 그런 경우에는 다음을 수행하는 것이 좋습니다 [처음부터 다시 컴파일](/latex/ko/knowledge-base/028-clearing-the-cache.md) 그래서 다음 컴파일이 여전히 **첫 오류에서 중지** 모드에서 깨끗한 상태로 시작하여 가장 관련 있는 첫 번째 오류를 보여줄 수 있습니다. 여전히 존재하지 않는 것처럼 보이는 파일에서 오류가 발생한다면—예: `output.aux`, `output.toc` 등—다음을 살펴보세요 [이 도움말 페이지](/latex/ko/knowledge-base/066-how-to-find-and-fix-errors-reported-in-generated-files.md).

## 좀 더 낮은 수준의 세부 사항

다음 **오류가 있어도 컴파일 시도** 컴파일 모드는 다음과 같이 실행됩니다 `latexmk` 다음 플래그와 함께:

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

다음 **첫 오류에서 중지** 컴파일 모드는 대신 latexmk를 다음 플래그와 함께 실행합니다:

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

이 페이지에 있는 김에 다음에 대해 더 읽어보는 것도 흥미로울 수 있습니다 [Overleaf가 다음을 사용하는 방법 `latexmk` 도구](/latex/ko/knowledge-base/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/ko/knowledge-base/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.