> 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/questions-and-answers/81-tips-and-tricks-for-troubleshooting-latex.md).

# LaTeX 문제 해결을 위한 팁과 요령

LaTeX 문제를 식별하고 해결하는 데 사용할 수 있는 몇 가지 팁과 요령이 있습니다. 일반적으로 다음을 사용해 디버그하는 것을 권장합니다 [첫 번째 오류에서 중지 컴파일 모드를 켠 상태로](/latex/ko/knowledge-base/149-using-the-stop-on-first-error-compilation-mode.md), 그러면 오류가 쌓이는 것을 방지할 수 있습니다. 오류를 만나면 다음 단계를 따라 해결할 수 있습니다:

1. **오류 또는 경고가 있나요?**

   Recompile 버튼 바로 오른쪽에 있는 "Logs and output files" 아이콘을 먼저 확인하세요.

   !["Logs and output files" 아이콘의 경고 표시](/files/f8a4ca9a7e3e7700294e25939083ca896aa8b020)

   경고 메시지는 주황색으로 표시됩니다. 이는 LaTeX가 평소와 다른 무언가를 발견하고 자동으로 조정했음을 알리는 경우가 많습니다. 문서의 최종 모양에 영향을 주지 않는다면 대개 무시해도 됩니다.

   예를 들어, 많은 부동 요소와 여백/간격 문제는 사용자가 수정할 필요 없이 LaTeX가 자동으로 바로잡습니다. Overleaf는 다음과 같은 특별한 경고를 보고합니다: [underfull 및 overfull 박스 경고](/latex/ko/knowledge-base/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors), 파란색으로 표시됩니다. 이들 대부분은 안전하게 무시할 수 있지만, 때때로 확인이 필요한 문서의 일부를 알려주기도 합니다.

   !["Logs and output files" 아이콘의 오류 표시.](/files/1df44d1b4c7e618831a33224f5de8ede646c81fb)

   오류 메시지는 빨간색으로 표시됩니다. 일반적으로 더 심각하며 문서가 정상적으로 컴파일되는 것을 막을 수 있습니다. 치명적인 오류는 문서가 아예 컴파일되지 못하게 할 수 있습니다.

   흔한 오류와 해결 방법 목록이 있습니다 [여기](/latex/ko/latex/05-errors.md). 오류는 가능한 한 빨리 수정하는 것이 좋습니다. 그대로 쌓아 두면 나중에 디버깅하기 어려운 치명적인 오류로 이어질 수 있습니다.
2. **메시지가 특정 오류나 줄 번호를 알려주나요?**

   ![줄 번호가 포함된 오류 메시지.](/files/63430943ae797355eb371dd9b56bc451c2da67c9)

   많은 경우 LaTeX 엔진은 정확한 오류를 알아내어 줄 번호를 알려줄 만큼 똑똑합니다. 위의 예에서는 기호가 있었습니다 `_`, 이는 LaTeX에서 다음과 같이 이스케이프해야 합니다: `\_`. 오류 메시지는 심지어 오류가 29행에 있다고 알려주고, 해당 줄을 강조 표시하며, 문제가 있는 텍스트의 일부도 보여줍니다. 오류 메시지를 클릭하면 소스 코드에서 오류가 발생한 파일과 줄 번호로 바로 이동할 수 있습니다.

   줄 번호가 표시되지 않으면 아래 단계들을 계속 시도해 보세요.
3. **오류 텍스트가 단서를 제공하나요?**

   ![문제가 .bbl 파일에 있음을 알려 주는 오류 메시지로, 참고문헌에 문제가 있음을 시사합니다.](/files/08a2f620a73c74ffea359e21c5583ad11f756d8a)

   위의 오류 메시지에는 줄 번호가 주어지지만, 평소 편집하는 파일은 아닙니다. 여기서 파일 확장자 .bbl은 컴파일을 막는 오류가 BibTeX 문제라는 단서를 줍니다.

   .bib 파일에서 강조 표시된 텍스트를 검색하면 오류의 원인을 찾을 수 있습니다. 때로는 [보조 파일과 로그 파일을 확인하면](/latex/ko/knowledge-base/150-view-generated-files.md) 짧은 메시지 대화 상자보다 더 구체적인 정보를 얻을 수 있습니다.
4. **이전 버전을 비교하고 변경 사항을 되돌리세요**

   이전에는 프로젝트가 문제없이 컴파일되었다면, 최근 수정에서 프로젝트에 오류를 도입했을 가능성이 큽니다. 다음을 사용할 수 있습니다 [기록 기능](/latex/ko/more-topics/49-using-the-history-feature.md) 을 사용해 최근 변경 사항을 되돌릴 수 있습니다.
5. **\end{document}를 옮겨 보세요**

   아직도 오류 위치를 좁히지 못했다면, 다음을 잘라서 `\end{document}` 주 .tex 파일의 맨 끝에서 잘라낸 뒤 프로젝트의 여러 부분에 붙여 넣어 보세요. 먼저 주 .tex 파일부터 시작하고, 필요하다면 주 파일에서 다음으로 불러오는 하위 파일들도 확인하세요 `\input{}` 또는 `\include{}`. 프로젝트/문서의 맨 끝에서 문서의 시작 부분으로 체계적으로 이동하면서, 한 번에 한 섹션씩 이 과정을 반복하세요. 작은 오류가 생기기 쉬운 수식이나 다른 복잡한 섹션에 특히 주의하세요.

   이 방법은 오류가 있는 섹션을 분리할 수 있을 때까지 문서를 점점 더 작은 범위로 좁히는 데 도움이 됩니다. 문서가 갑자기 컴파일되기 시작하면, 문제가 있는 섹션을 찾았다는 뜻입니다. 많은 경우 문제는 잘못 입력한 명령, 이스케이프하지 않은 특수 문자, 또는 빠진 괄호처럼 아주 단순한 것일 수 있습니다.
6. **컴파일 "시간 초과" 오류인가요?**

   어떤 경우에는 특정 조건에서 시간 초과 컴파일 오류가 발생할 수 있습니다. 이는 서버의 리소스/컴파일 시간 제한 때문입니다. 무료 계정과 유료 계정에는 서로 다른 시간 제한이 적용됩니다. 다음을 위해 사용할 수 있는 여러 팁이 있습니다 [문서가 더 빨리 컴파일되게 하는](/latex/ko/knowledge-base/038-fixing-and-preventing-compile-timeouts.md), 그리고 이것들이 효과가 없다면 다음과 함께 언제든지 문의해 주세요 [지원 요청](https://www.overleaf.com/contact).
7. **“PDF 렌더링” 오류인가요?**

   다른 온라인 서비스와 마찬가지로, Overleaf를 사용할 때 때때로 문제가 발생할 수 있습니다. 브라우저 상태, 브라우저 확장 프로그램, 서비스 제공업체의 일시적인 장애, 네트워크 설정 문제 등이 원인이 될 수 있습니다.

   연결 문제가 있거나 편집기 또는 PDF 뷰어의 일부가 예상대로 로드되거나 표시되지 않는다면 다음의 문제 해결 단계를 시도해 보세요 [이 페이지](/latex/ko/knowledge-base/125-resolving-access-loading-and-display-problems.md).
8. **포럼을 이용해 보세요**

   줄 번호가 주어지지 않고, 제시된 오류 메시지도 해독할 수 없다면, 즐겨 사용하는 검색 엔진에 간단히 "복사-붙여넣기" 해 보는 것만으로도 비슷한 문제를 겪은 전문가 사용자들의 정보를 찾을 수 있습니다. 훌륭한 TeX 관련 포럼으로는 다음이 있습니다 [LaTeX Stack Exchange](https://tex.stackexchange.com/) 및 [LaTeX Community](https://latex.org/forum/).
9. **문의하기**

   마지막으로, 언제든지 다음을 보내실 수 있습니다 [지원 요청](https://www.overleaf.com/contact). 문제가 LaTeX 관련이든 사이트 관련이든, 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/ko/questions-and-answers/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.