---
title: 콘솔 창 참조
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/unity-editor/editor-windows-views-reference/console
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/unity-editor/editor-windows-views-reference/console.md
generated_at: 2026-11-19T18:38:36.120Z
locale: ko-kr
---

# 콘솔 창 참조

> 스크립트와 Unity 에디터 오류 메시지, 경고, 디버그 로그를 확인합니다.

**콘솔** 창에는 에디터가 생성하는 오류, 경고 및 기타 메시지가 표시됩니다. 이러한 오류와 경고는 스크립트 컴파일 오류와 같은 프로젝트의 문제를 찾는 데 도움이 됩니다. 또한 누락된 메타 파일을 교체하는 등 에디터가 자동으로 수행하는 작업에 대해 경고합니다. 이는 프로젝트의 다른 곳에서 문제가 발생할 수 있습니다.

프로젝트 디버깅을 돕기 위해 [Debug](/engine/6000.0/manual/scripting/debugging-and-diagnostics/class-debug.md) 클래스를 사용하여 자체 메시지를 콘솔에 출력합니다. 예를 들어 스크립트의 특정 지점에서 변수 값을 출력하여 변수가 어떻게 변하는지 확인할 수 있습니다.

이 페이지에서는 콘솔 창 작업 시 사용할 수 있는 옵션과 특정 키워드를 검색하여 메시지를 필터링하는 방법에 대해 설명합니다.

## 콘솔 창 인터페이스##console-window-interface

콘솔을 열려면 Unity 메인 메뉴에서 **Window** > **General** > **Console**으로 이동합니다.


**The Console window displays a series of error messages and a warning.:**
![](/api/media?file=/engine/6000.0/media/images/Console.png)

**A**. 콘솔 Editor에는 메시지를 표시하는 방법을 제어하고 메시지를 [검색하고 필터링하는](#search) 옵션이 있습니다.

B. 콘솔 창 메뉴에는 목록에 표시되는 [각 메시지의 양](#line-count)을 제어하고 스택 추적 옵션을 설정하는 [로그 파일을 여는](#log-file) 옵션이 있습니다.

**C**. 콘솔 리스트에는 각 로깅된 메시지의 엔트리가 표시됩니다. 전체 텍스트를 세부 정보 영역에 표시할 메시지를 선택합니다. 여기에서 표시할 각 메시지의 줄 수를 선택할 수 있습니다. 아래의 [라인 수 조절](#line-count)을 참조하십시오.

-**D** 세부 정보 영역에는 선택한 메시지의 전체 텍스트가 표시됩니다. 스택 추적을 활성화하면 코드 파일의 특정 줄에 대한 레퍼런스가 클릭 가능한 링크로 표시됩니다.

## 콘솔 툴바 옵션##console-toolbar-options

콘솔 창 툴바 메시지를 표시하는 방법을 제어하고 메시지를 검색하고 필터링하는 옵션이 있습니다.

| 옵션           |              | \*\*함수                                                                                                                                                                                                                                                              |
| ------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **지우기**      |              | 코드에서 생성된 모든 메시지를 제거하지만 컴파일러 오류는 유지합니다.지우기 옵션이 있는 드롭다운 메뉴를 엽니다.                                                                                                                                                                                                      |
|              | 플레이 시 지우기    | 플레이 모드를 시작할 때마다 콘솔을 자동으로 지웁니다.                                                                                                                                                                                                                                      |
|              | 빌드 시 지우기     | 프로젝트를 빌드할 때 콘솔을 지웁니다.                                                                                                                                                                                                                                               |
|              | 다시 컴파일 시 지우기 | 프로젝트를 다시 컴파일할 때 콘솔을 지웁니다.                                                                                                                                                                                                                                           |
| **접기**       |              | 반복되는 오류 메시지의 첫 번째 인스턴스만 표시합니다.이는 프레임 업데이트마다 생성되는 null 참조와 같은 런타임 오류에 유용합니다.                                                                                                                                                                                         |
| **오류 일시 정지** |              | 스크립트에서 [`Debug.LogError`](/engine/6000.0/script-reference/unityengine/debug/logerror.md)를 호출할 때마다 재생을 일시 중지합니다.실행 시 특정 지점에서 재생을 고정하고 씬을 검사하는 데 사용합니다. 이 옵션은 스크립트에서 [`Debug.Log`](/engine/6000.0/script-reference/unityengine/debug/log.md)를 호출할 때 재생을 일시 중지하지 않습니다. |
| **연결 플레이어**  |              | 원격 기기에서 실행 중인 개발 빌드에 연결하고 해당 플레이어 로그를 콘솔에 표시하는 옵션이 있는 드롭다운 메뉴를 엽니다.이 옵션은 타겟 개발 빌드(콘솔 창 표시되는 로그의 빌드)의 이름으로 레이블이 지정됩니다. 콘솔이 원격 빌드에 연결되어 있지 않으면 콘솔 창에 표시된 로그가 로컬 Unity 에디터의 로그임을 표시하기 위해 **에디터**라고 표시됩니다.                                                              |
|              | 플레이어 로깅      | 콘솔이 원격 개발 빌드에 연결되어 있으면 빌드에 대한 플레이어 로깅이 활성화됩니다.이 옵션을 비활성화하면 로깅이 일시 중지되지만 콘솔은 타겟 빌드에 계속 연결됩니다.이 옵션을 비활성화하면 이 드롭다운 메뉴의 나머지 옵션도 숨겨집니다.콘솔 창에 로그를 표시하려면 **플레이어 로깅** 아래에 나열된 빌드를 선택합니다.                                                                                    |
|              | 에디터          | 콘솔이 원격 **개발 빌드**에 연결된 경우 이 옵션을 선택하여 원격 빌드의 로그 대신 로컬 Unity 플레이어의 로그를 표시합니다.                                                                                                                                                                                          |
|              | `<Enter IP>` | 원격 디바이스에서 개발 빌드의 IP 주소를 지정할 수 있는 **Enter Player IP** 다이얼로그를 엽니다.빌드에 연결하려면 다이얼로그에서 **Connect**를 선택하고 드롭다운 메뉴 하단의 개발 빌드 목록에 추가합니다.                                                                                                                                    |
|              | \[개발 빌드]     | 사용 가능한 개발 빌드를 나열합니다. 여기에는 자동으로 감지된 빌드와 **Enter IP** 옵션을 사용하여 추가하는 빌드가 포함됩니다.                                                                                                                                                                                        |

## 콘솔 출력 검색 및 필터링

콘솔 검색창에서 특정 키워드에 대한 콘솔 메시지를 검색할 수 있습니다. 검색어를 입력하면 콘솔이 메시지를 필터링하여 일치하는 텍스트가 포함된 메시지만 표시합니다. 콘솔은 메시지 텍스트의 첫 번째 매치만 강조 표시하며, 메시지가 표시된 부분에 있는 경우에만 강조 표시됩니다(아래의 [라인 수 조절](#line-count) 참조).


**Searching for the term “name” highlights the first match in each message:**
![](/api/media?file=/engine/6000.0/media/images/ConsoleSearch.png)

숫자와 특수 문자를 포함하여 콘솔 메시지에 표시되는 모든 것을 검색할 수 있습니다. 예를 들어 콘솔이 메시지를 기록한 시간을 검색할 수 있습니다.

검색은 검색창에 입력한 항목과 정확히 일치하는 항목을 검색합니다. 두 개의 서로 다른 용어를 한 번에 검색하거나 일반적인 검색 엔진 연산자를 사용할 수는 없습니다.

타입별로 콘솔 메시지를 필터링할 수도 있습니다. 검색창 옆에 있는 버튼을 클릭 수 토글합니다.

| **버튼**                                                                                                            | \*\*함수                                  |
| ----------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| &#xA;**Messages switch:**&#xA;![](/api/media?file=/engine/6000.0/media/images/ConsoleFilterMessage.png)**메시지 전환** | 콘솔의 메시지 수를 표시합니다. 클릭 수 메시지를 표시하거나 숨깁니다. |
| &#xA;**Warnings switch:**&#xA;![](/api/media?file=/engine/6000.0/media/images/ConsoleFilterWarning.png)**경고 스위치** | 콘솔의 경고 수를 표시합니다. 클릭 수 경고를 표시하거나 숨깁니다.   |
| &#xA;**Errors switch:**&#xA;![](/api/media?file=/engine/6000.0/media/images/ConsoleFilterError.png)**오류 전환**      | 콘솔의 오류 수를 표시합니다. 클릭 수 오류가 표시되거나 숨겨집니다.  |

## 라인 수 조정

각 콘솔 엔트리는 최대 10줄이 될 수 있습니다.

리스트에 표시되는 각 항목의 줄 수를 제어하려면 콘솔 메뉴 버튼을 클릭하고 메뉴에서 **로그 항목** > **\[X] 라인**을 선택합니다. 여기서 각 항목에 표시할 줄 수는 **X**입니다.


**Log entry line count:**
![](/api/media?file=/engine/6000.0/media/images/ConsoleAdjustLineCount.png)

라인 수가 클수록 각 엔트리의 텍스트가 더 많이 표시되지만, 주어진 시간에 표시되는 엔트리 수는 줄어듭니다. 줄 수는 항상 전체 메시지 텍스트를 검색하는 콘솔 검색 함수에 영향을 주지 않습니다. 일치하는 텍스트가 숨겨진 라인에 있는 경우 검색은 결과에 메시지를 반환하지만, 일치하는 텍스트를 표시하거나 강조 표시하기 위해 확장하지 않습니다. 세부 정보 영역에서 전체 메시지 텍스트를 볼 수 있지만, 해당 텍스트가 강조 표시되지 않습니다.

## 스택 추적 로깅##stack-trace-logging

Unity 콘솔 메시지 및 로그 파일에는 자세한 스택 추적 정보가 포함될 수 있습니다. [스택 추적 로깅](/engine/6000.0/manual/scripting/debugging-and-diagnostics/stack-trace.md) 설정을 사용하여 스택 추적 정보의 양을 제어할 수 있습니다.

## 콘솔에서 로그 파일 열기

Unity 또는 코드가 콘솔 창에 작성하는 모든 내용도 [로그 파일](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)에 기록됩니다. 콘솔 창 메뉴에서 로그 파일을 열 수 있습니다. **Open Player Log** 또는 **Open Editor Log**를 선택합니다.
