> 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/latex-1/14-latex-error-environment-xxx-undefined.md).

# LaTeX 오류: 환경 XXX가 정의되지 않음

LaTeX가 인식하지 못하는 환경을 사용하려고 하면, 아래와 같은 오류 메시지가 생성됩니다:

main.tex, 5행

LaTeX 오류: environment equation\*가 정의되지 않았습니다.

설명은 LaTeX 매뉴얼 또는 LaTeX Companion을 참조하세요. 즉시 도움말을 보려면 H를 입력하세요. ... l.5 \begin{equation\*} 해당 명령은 무시되었습니다. 다른 명령으로 바꾸려면 I를 입력하거나, 아니면 그대로 계속하세요.

## 일반적인 원인

**패키지를 불러오는 것을 잊었습니다**

이 오류의 일반적인 원인 중 하나는 특정 패키지의 일부인 환경을 사용하려고 하지만, 프리앰블에 해당 패키지를 불러오지 않았기 때문입니다. 그 예로 **`align`** 환경입니다. 그 **`align`** 환경은 **`amsmath`** 패키지의 일부로 제공됩니다. 따라서 **`align`** 환경을 사용할 때마다 **`\usepackage{amsmath}`** 아래와 같이 프리앰블에 포함해야 합니다:

```latex
% 프리앰블에

\usepackage{amsmath}

% 메인 .tex 파일에

\begin{align}
2x + 3y &= 7\\
5x - 2y &= 2
\end{align}
```

![Align.PNG](/files/c45ea8161b7019461b5f8dc6c27edac009784dd7)

포함하지 않으면 **`\usepackage{amsmath}`** 프리앰블에, 오류 메시지가 생성됩니다.

**환경 이름을 잘못 입력했습니다:**

이 오류의 또 다른 일반적인 예는 환경 이름이 올바르게 철자된 경우입니다. 이 실수의 예는 아래에 나와 있습니다:

```latex
\begin{lisQ}
    \item 이것은 목록 항목입니다
    \item 이것은 또 다른 목록 항목입니다
\end{lisQ}
```

여기에서 오류가 나타납니다. 왜냐하면 **`목록`** 환경이 실수로 **`lisQ`**로 작성되었기 때문입니다. 이를 수정하려면 특정 환경을 호출할 때마다 철자를 확인하기만 하면 됩니다.

**존재하지 않는 환경**

이 오류가 나타나는 또 다른 경우는 존재하지 않는 환경을 사용하려고 할 때입니다. LaTeX에서 허용되는 환경과 직접 만드는 방법에 대해 자세히 알아보려면 저희의 [문서를 확인하세요](/latex/ko/commands/02-environments.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/latex-1/14-latex-error-environment-xxx-undefined.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.