개발 · 도구 다루기
유니티 콘솔 창으로 오류 위치 찾기
재생 버튼을 눌렀는데 캐릭터가 움직이지 않고, 화면 아래쪽에 빨간 글씨 한 줄이 떠 있습니다. 많은 입문자가 이 줄을 대충 넘기고 코드를 처음부터 다시 훑어보지만, 사실 그 한 줄에 문제가 생긴 스크립트와 줄 번호가 이미 적혀 있습니다. 유니티 콘솔 창이 무엇을 보여 주는지, 오류 위치를 찾아가는 순서는 어떻게 되는지 정리했습니다.
작업 노트 476 · 읽는 시간 약 5분 · 2026.11.17 정리
콘솔 창의 목적: 엔진과 코드가 남기는 기록을 모아 보는 곳
콘솔 창은 유니티 편집기와 내 스크립트가 남기는 메시지를 시간 순서대로 모아 보여 주는 창입니다. 상단 메뉴의 Window, General 아래에서 열 수 있습니다. 메시지는 일반 기록, 경고, 오류 세 종류로 나뉘며, 각각 다른 아이콘으로 표시됩니다. 검색창 옆의 버튼으로 종류별 메시지를 보이거나 숨길 수 있고, 버튼마다 해당 메시지 개수가 함께 나옵니다.
오류는 크게 두 갈래입니다. 하나는 스크립트를 저장했을 때 문법이 틀려서 생기는 컴파일 오류이고, 다른 하나는 문법은 맞지만 게임 실행 중에 문제가 생기는 실행 중 오류입니다. 컴파일 오류가 하나라도 있으면 재생 자체가 되지 않으니 가장 먼저 고쳐야 합니다. 실행 중 오류는 재생해 봐야 나타나며, 특정 상황에서만 생기기도 합니다.
내 코드에서 직접 메시지를 남길 수도 있습니다. Debug.Log로 일반 기록을, Debug.LogWarning으로 경고를, Debug.LogError로 오류를 콘솔에 찍습니다. 변수 값이 예상대로 바뀌는지 확인하고 싶을 때 이 기능을 가장 많이 씁니다. 콘솔은 오류를 보여 주는 창이면서, 코드 내부를 들여다보는 창이기도 합니다.
오류 메시지 한 줄을 읽는 순서
오류 메시지에는 보통 세 가지 정보가 들어 있습니다. 어떤 종류의 오류인지, 어느 스크립트 파일인지, 그 파일의 몇 번째 줄인지입니다. 예를 들어 플레이어 스크립트의 25번째 줄에서 참조가 비어 있다는 오류라면, 25번째 줄에서 쓰는 변수 중 연결되지 않은 것이 있다는 뜻입니다. 오류 이름이 영어라 겁이 나더라도 파일 이름과 줄 번호부터 찾아보면 됩니다.
메시지를 선택하면 콘솔 아래쪽 상세 영역에 전체 내용이 펼쳐집니다. 여기에 나오는 여러 줄은 오류가 생기기까지 어떤 함수들이 차례로 호출되었는지 보여 주는 스택 트레이스입니다. 공식 문서에 따르면 스택 트레이스 기록이 켜져 있으면 상세 영역의 파일과 줄 정보가 코드로 바로 이어지는 링크가 됩니다. 가장 위쪽에 있는 내 스크립트 줄부터 눌러 보는 것이 순서입니다.
오류가 여러 개 떠 있다면 맨 위의 첫 번째 오류부터 봅니다. 첫 오류 때문에 뒤따라 생긴 오류가 많기 때문입니다. 첫 오류를 고치고 다시 재생하면 나머지가 함께 사라지는 경우가 흔합니다. 반대로 맨 아래의 마지막 오류부터 고치려 하면 원인이 아닌 결과를 붙잡고 시간을 쓰게 됩니다.
도구 버튼 활용: 지우기, 접기, 오류 일시정지, 검색
지우기 버튼은 내 코드가 남긴 메시지를 지웁니다. 컴파일 오류는 고치기 전까지 지워지지 않습니다. 지우기 버튼 옆의 메뉴에서 재생할 때마다 자동으로 지우는 설정을 켜 두면, 이전 재생의 메시지와 섞이지 않아 이번 재생에서 생긴 문제만 볼 수 있습니다. 빌드나 재컴파일 때 자동으로 지우는 설정도 함께 있습니다.
접기 버튼은 같은 메시지가 반복될 때 하나로 묶어 보여 줍니다. Update 안에서 생기는 오류는 매 프레임 반복되어 수백 줄이 쌓이기 쉬운데, 접기를 켜면 한 줄로 묶이고 반복 횟수만 표시됩니다. 오류 일시정지 버튼을 켜면 Debug.LogError가 호출되는 순간 재생이 멈춥니다. 오류가 생긴 바로 그 순간의 씬 상태를 하이어라키와 인스펙터로 살펴볼 수 있어 원인을 찾기 좋습니다.
검색창에 단어를 입력하면 그 단어가 들어간 메시지만 남습니다. 내가 찍은 기록 메시지 앞에 '[점프]', '[점수]'처럼 꼬리표를 붙여 두면, 검색창에 꼬리표만 입력해 원하는 기록만 골라 볼 수 있습니다. 공식 문서에 따르면 검색은 입력한 글자와 정확히 일치하는 내용만 찾으므로, 꼬리표를 일정한 형식으로 붙이는 습관이 도움이 됩니다. 버튼 위치와 이름은 버전에 따라 다를 수 있습니다.
자주 만나는 오류와 고치는 순서
입문자가 가장 자주 만나는 실행 중 오류는 비어 있는 참조를 쓰려고 할 때 생기는 오류입니다. 스크립트의 변수 칸에 오브젝트를 연결하지 않았거나, 찾으려던 오브젝트가 씬에 없을 때 생깁니다. 오류 줄을 찾아가 그 줄에서 쓰는 변수를 확인하고, 인스펙터에서 해당 칸이 비어 있지 않은지 봅니다.
컴파일 오류는 세미콜론 빠짐, 중괄호 짝 안 맞음, 변수 이름 오타처럼 문법 실수에서 옵니다. 오류 줄 번호가 실제 실수 위치보다 한두 줄 뒤를 가리키는 경우도 있어서, 표시된 줄과 그 바로 위 줄을 함께 봅니다. 스크립트 파일 이름과 클래스 이름이 다를 때도 문제가 생길 수 있으니, 새 스크립트를 만든 뒤 이름을 바꿨다면 이 부분도 확인합니다.
오류가 없는데 동작이 이상하다면 콘솔에 직접 기록을 남겨 추적합니다. 의심되는 함수의 시작 부분에 기록 한 줄을 넣어 그 함수가 실제로 호출되는지 보고, 변수 값을 출력해 어느 시점부터 예상과 달라지는지 찾습니다. 문제를 찾은 뒤에는 디버깅용 기록을 지우거나 꺼 두어 콘솔이 다시 깨끗해지게 합니다.
콘솔을 습관처럼 보는 작업 흐름
콘솔은 문제가 생겼을 때만 여는 창이 아니라 늘 화면 한쪽에 두는 창입니다. 스크립트를 저장하고 편집기로 돌아올 때마다 콘솔에 새 오류가 생겼는지 확인하고, 재생할 때마다 경고까지 한 번 훑어봅니다. 경고는 당장 게임을 멈추지 않지만, 쌓아 두면 나중에 진짜 오류를 찾기 어렵게 만듭니다. 경고가 생기면 그날 안에 정리하는 것이 좋습니다.
오류를 해결했다면 짧은 기록을 남겨 둡니다. 어떤 오류 메시지였고, 원인이 무엇이었고, 어떻게 고쳤는지 세 줄이면 됩니다. 같은 오류는 반복해서 나오기 마련이라, 이 기록이 쌓이면 두 번째부터는 몇 분 안에 해결할 수 있습니다. 포트폴리오의 개발 기록에 문제 해결 과정을 넣을 때도 그대로 쓸 수 있습니다.
오류를 혼자 찾는 힘은 개발자에게 가장 기본이 되는 능력입니다. SBS아카데미게임학원 유니티 과정은 강사의 1:1 맞춤 피드백과 멘토 코칭으로 막히는 지점을 함께 짚어 가며 진행합니다. 콘솔의 빨간 글씨 앞에서 자주 멈춘다면, 무료 상담에서 지금 막힌 상황을 이야기하고 어디부터 다져야 할지 정해 보세요.
자주 묻는 질문
경고는 무시해도 되나요?
당장 게임이 돌아가더라도 쌓아 두지 않는 것이 좋습니다. 경고 중에는 나중에 오류로 이어지거나 성능 문제를 알려 주는 것도 있습니다.
빌드한 게임의 오류는 어디서 보나요?
빌드된 게임은 로그 파일에 기록을 남깁니다. 콘솔 창 메뉴에서 플레이어 로그와 편집기 로그를 여는 기능을 찾을 수 있으며, 개발용 빌드에 연결해 기록을 보는 방법도 있습니다.
확인한 자료
외부 기관의 기준과 안내는 바뀔 수 있으니 최신 내용은 해당 기관에서 확인해 주세요.

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.
과정 보기 →