LaTeX 컴파일 실패: 세 단계로 원인 찾기

현재 컴파일 상태와 첫 실제 오류를 확인하세요. 뒤의 메시지는 별개 문제가 아니라 같은 원인에서 이어질 수 있습니다.

1. 작업과 첫 오류

대기·실행 중인 작업이 끝나면 Bug 오류 패널에서 오류와 원본 로그를 봅니다. 흔한 형식은 다음과 같습니다.

1! Undefined control sequence.2l.42 \texbf{결과}

1./main.tex:42: Undefined control sequence.

\texbf는 \textbf의 오타입니다. 문헌 처리 실패나 시간 초과는 다른 메시지를 쓸 수 있으므로 실제 실패 이유를 보세요.

2. 파일, 줄, 문맥

l.42, main.tex:42는 TeX가 감지한 위치이지 반드시 시작점은 아닙니다. 빠진 중괄호가 다음 문단에서 나타날 수 있습니다. 메인·장·템플릿을 구분하고 앞의 그룹·환경 경계를 살펴보세요.

유효한 파일·줄 정보가 있으면 해당 위치로 이동하는 기능을 사용합니다. 첫 오류를 수정하고 재컴파일한 뒤 독립된 나머지를 판단하세요.

3. 복사본에서 완전한 블록으로 분리

큰 변경 전에는 프로젝트를 내려받거나 복원 버전을 보관합니다.

1. 최근 수정부터 확인합니다.
2. 명령 인수를 자르지 말고 전체 절·수식·표·목록으로 나눕니다.
3. 서문·의존성을 남긴 채 의심 부분의 절반가량을 임시로 제외합니다.
4. 원래 오류가 남는지에 따라 좁힙니다. 새 미정의 명령이 생기면 빠진 의존성을 복구하세요.

PDF가 보여도 성공은 아님

• 경고와 함께 생성될 수 있으므로 넘침·배치를 확인합니다.
• 최신 소스가 실패하면 이전 PDF가 보일 수 있습니다. 메인 파일과 현재 작업을 보세요.
• 오류가 있는 미검증 미리보기 상태는 추가 조사가 필요합니다.

최소 프로젝트와 비교

빈 프로젝트에서 XeLaTeX를 선택하고 kotex가 포함된 다음 예제를 메인에 넣습니다. 원래 내용과 의존성을 조금씩 추가하세요.

1\documentclass[a4paper,11pt]{article}2\usepackage{kotex}3\usepackage{amsmath}4\begin{document}5최소 시험 문서입니다.6\end{document}

흔한 오류 세 가지

Agent에 조사 요청

Bug 패널의 AI 수정은 Agent를 열고 요청을 전송합니다. Chat & Agent에서 “첫 실제 오류를 찾고 필요한 부분만 고친 뒤 컴파일해 남은 문제를 보고하세요”라고 요청할 수도 있습니다. 변경 사항, 현재 작업, PDF를 직접 확인하세요.

문헌 관리와 AI 생성 오류 예방을 참고하세요.