LaTeX가 출력하는 메시지의 빠른 참고표입니다. 오류(!)는 빌드를 멈추고, 경고는 멈추지 않지만 실제 문제(깨진 줄, 망가진 참조)를 알려 주는 경우가 많습니다. 자주 나오는 메시지를 의미와 일반적인 대처와 함께 정리합니다. (읽는 법과 ? 프롬프트는 “오류 읽기와 디버깅”을 보세요.)
TeX 오류
| 메시지 | 원인과 대처 |
|---|
! Undefined control sequence | 알 수 없는 명령: 오타이거나 패키지를 불러오지 않음 |
! Missing $ inserted | 수식 모드 밖의 수학 기호: $...$로 감싸기 |
! Too many }'s | }가 {보다 많음 |
! Missing } inserted | 닫히지 않은 { |
! Misplaced alignment tab character & | 표 밖에서 & 사용; 문자 자체는 \& |
LaTeX 오류
| 메시지 | 원인과 대처 |
|---|
LaTeX Error: File not found | 패키지/파일 누락: tlmgr로 설치하고 철자 확인 |
Environment undefined | 정의되지 않은 환경: 패키지 미로드 또는 오타 |
\begin{x} ended by \end{y} | \begin/\end 불일치 또는 중첩 붕괴 |
Something's wrong--perhaps a missing \item | 빈 목록이거나 첫 \item 앞에 본문이 있음 |
Command \x already defined | 기존 명령 재정의: \renewcommand 사용 |
LaTeX 경고
| 메시지 | 의미와 대처 |
|---|
Overfull \hbox | 행이 오른쪽 여백을 넘침: 문장 수정, 하이픈 처리, 국소적 \sloppy |
Underfull \hbox | 줄이 지나치게 느슨함(badness): 문장 수정 또는 줄바꿈 조정 |
Reference undefined | \ref/\label 불일치 또는 한 번 더 컴파일 |
Citation undefined | 알 수 없는 문헌 키 또는 bibtex/biber 미실행 |
Label multiply defined | 같은 라벨이 두 번 정의됨 |
Font shape undefined | 글꼴 선언 오류/미설치; 기본값으로 대체됨 |
흔한 오용
- 닫히지 않은
$ → 수식 모드가 계속됩니다. 항상 짝을 맞추세요. - 너무 많은
& → 표의 열 수에 맞추세요. 문자 자체는 \&. \\ 오용 → 문단 구분은 빈 줄로 합니다. 마지막 줄이나 제목 직후에는 \\가 필요 없습니다.- 중괄호
{ } 불일치 → 편집기의 괄호 매칭 기능으로 빠르게 찾습니다.
