개발 · 용어 풀이
코루틴은 무엇이고 언제 쓸까
버튼을 누르면 3초 뒤에 문이 열리고, 그동안 화면 위 숫자가 3, 2, 1로 줄어들게 하고 싶다고 해 봅시다. Update 안에서 시간을 직접 세어도 되지만 변수가 금세 늘어납니다. 이럴 때 유니티 개발자가 꺼내는 도구가 코루틴입니다. 관련 용어를 하나씩 풀고, 언제 쓰고 언제 피하는지 장면으로 정리합니다.
작업 노트 484 · 읽는 시간 약 5분 · 2026.11.17 정리
코루틴과 그 주변 용어 한 줄 정의
- 코루틴: 실행 도중 잠시 멈췄다가 다음 프레임이나 정해진 시간 뒤에 멈춘 자리부터 이어서 실행되는 함수
- IEnumerator: 코루틴 함수가 돌려주는 형식. 함수 이름 앞에 이 형식을 적어야 코루틴으로 쓸 수 있음
- yield return: 여기서 잠깐 멈추라는 표시. 뒤에 무엇을 적느냐에 따라 기다리는 조건이 달라짐
- StartCoroutine과 StopCoroutine: 코루틴을 시작하고 멈추는 명령
이 네 가지는 따로 노는 개념이 아니라 한 세트입니다. IEnumerator 형식으로 함수를 만들고, 그 안에 yield return으로 쉬는 지점을 표시하고, StartCoroutine으로 실행합니다. 셋 중 하나라도 빠지면 코루틴이 동작하지 않거나 일반 함수처럼 한 번에 끝나 버립니다. 처음에는 이 세트 구조를 통째로 외워 두는 것이 편합니다.
자주 쓰는 기다림 조건도 알아 둡니다. yield return null은 다음 프레임까지, WaitForSeconds는 정해진 초만큼 기다립니다. 게임 시간 배속과 상관없이 실제 시간으로 기다리고 싶으면 WaitForSecondsRealtime을 씁니다. 일시정지 화면처럼 시간 배속을 0으로 만드는 경우 이 차이가 결과를 완전히 바꿉니다.
실제 작업에서 코루틴이 나오는 장면
가장 흔한 장면은 시간 차를 둔 연출입니다. 피격되었을 때 캐릭터를 0.1초 간격으로 깜빡이게 하거나, 대화창 글자를 한 글자씩 찍어 내거나, 화면을 서서히 어둡게 했다가 씬을 넘기는 효과가 그렇습니다. 반복문 안에 yield return을 넣으면 매 프레임 조금씩 값이 바뀌는 흐름을 한 함수 안에서 읽기 쉽게 쓸 수 있습니다.
두 번째 장면은 순서가 있는 이벤트입니다. 보스가 등장할 때 카메라가 이동하고, 2초 뒤 이름이 뜨고, 이름이 사라지면 전투 음악이 시작되는 흐름을 생각해 보세요. Update로 쓰면 지금 몇 번째 단계인지 기억하는 변수가 필요하지만, 코루틴으로 쓰면 위에서 아래로 순서대로 적으면 됩니다. 기획서에 적힌 순서와 코드 모양이 비슷해 수정도 쉬워집니다.
세 번째는 일정 간격으로 반복하는 일입니다. 2초마다 적을 하나씩 생성하거나, 1초마다 독 데미지를 주는 기능이 예입니다. 무한 반복문 안에 대기 조건을 넣어 두고, 조건이 끝나면 StopCoroutine으로 멈춥니다. 다만 매 프레임 정밀하게 계산해야 하는 물리 처리는 코루틴보다 정해진 업데이트 함수에서 다루는 편이 맞습니다.

처음 배울 때 헷갈리는 세 가지
첫째, 코루틴은 별도의 스레드가 아닙니다. 다른 일을 병렬로 동시에 처리하는 것처럼 보이지만, 실제로는 메인 흐름 안에서 프레임마다 조금씩 이어서 실행될 뿐입니다. 그래서 코루틴 안에서 아주 무거운 계산을 멈춤 없이 돌리면 그동안 게임 전체가 멈춥니다. 무거운 작업은 여러 프레임에 나누어 처리해야 합니다.
둘째, 코루틴은 그것을 실행한 게임오브젝트가 비활성화되거나 파괴되면 함께 멈춥니다. 반면 스크립트 컴포넌트의 체크만 끈 경우에는 계속 돌아갑니다. 적이 죽어서 오브젝트를 끄는 순간 진행 중이던 깜빡임 연출이 중간에 끊기는 버그가 대개 이 때문에 생기며, 색이 원래대로 돌아오지 않은 채 남기도 합니다.
셋째, 같은 코루틴을 여러 번 시작하면 여러 개가 동시에 돌아갑니다. 버튼을 연타했더니 페이드 효과가 겹쳐 화면이 이상하게 깜빡였다면 이 경우입니다. 시작할 때 돌려받은 값을 변수에 저장해 두고, 다시 시작하기 전에 이전 것을 멈추거나 이미 실행 중인지 확인하는 조건을 넣으면 해결됩니다.
코루틴 대신 다른 방법이 나은 경우
모든 시간 처리를 코루틴으로 할 필요는 없습니다. 매 프레임 입력을 받아 캐릭터를 움직이는 일은 Update가 자연스럽고, 단순히 몇 초 뒤 함수 하나만 실행하면 되는 경우는 더 짧은 방법도 있습니다. 코루틴이 빛나는 곳은 기다림과 순서가 여러 번 섞이는 흐름입니다. 대기가 한 번뿐이라면 코드가 과하게 길어지지 않는지 따져 봅니다.
코루틴이 너무 많아져도 문제가 됩니다. 수십 개의 오브젝트가 각자 무한 반복 코루틴을 돌리면 어떤 것이 언제 멈추는지 추적하기 어렵습니다. 이럴 때는 관리자 역할의 스크립트 하나가 시간을 세고 필요한 대상에게 신호를 보내는 구조가 더 깔끔할 수 있습니다. 프로파일러에서 같은 함수가 비정상적으로 많이 돌고 있다면 구조를 다시 보라는 신호입니다.
유니티 버전에 따라 비동기 처리를 위한 다른 문법도 제공되지만, 입문 단계에서는 코루틴으로 시간과 순서를 다루는 감각을 먼저 잡는 것이 좋습니다. 기존 프로젝트와 튜토리얼에서 여전히 많이 쓰이므로, 남이 짠 코드를 읽기 위해서라도 코루틴 구조는 익숙해져야 합니다.

직접 써 보며 익히는 작은 연습 순서
- 숫자 3, 2, 1을 1초 간격으로 콘솔에 찍는 코루틴 만들기
- 같은 코루틴을 화면 텍스트에 표시하도록 바꾸기
- 버튼을 연타해도 카운트가 하나만 돌도록 중복 실행 막기
- 카운트 도중 오브젝트를 비활성화해 보고 어떻게 되는지 관찰하기
- 시간 배속을 0으로 바꿔 WaitForSeconds와 WaitForSecondsRealtime 차이 확인하기
각 단계에서 예상한 결과를 먼저 적고 실행해 보면, 틀린 부분이 곧 아직 이해하지 못한 개념입니다. 특히 네 번째와 다섯 번째 단계는 실무 버그와 직결되므로 결과를 메모해 두면 나중에 비슷한 문제를 만났을 때 원인을 빨리 떠올릴 수 있습니다. 함수의 자세한 동작은 유니티 공식 매뉴얼에서 버전에 맞춰 확인합니다.
SBS아카데미게임학원 유니티 과정은 C# 문법을 익힌 뒤 UI 연동과 애니메이션 제어를 코드로 구현하는 단계로 넘어가므로, 코루틴 같은 시간 처리 도구를 실제 기능 안에서 써 보게 됩니다. 혼자 연습하다 어디서 막히는지 정리가 안 된다면 무료 상담에서 지금까지 짠 코드를 보여 주고 다음 단계를 함께 정해 보세요.
자주 묻는 질문
코루틴 안에서 다른 코루틴을 기다릴 수 있나요?
가능합니다. 다른 코루틴을 yield return으로 실행하면 그 코루틴이 끝날 때까지 기다린 뒤 다음 줄로 넘어갑니다.
코루틴을 쓰면 게임이 느려지나요?
적당히 쓰면 큰 부담은 없습니다. 다만 매 프레임 새 대기 객체를 만들거나 지나치게 많은 코루틴을 동시에 돌리면 성능에 영향을 줄 수 있어 프로파일러로 확인합니다.
확인한 자료
외부 기관의 기준과 안내는 바뀔 수 있으니 최신 내용은 해당 기관에서 확인해 주세요.

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