[Unity C#] Coroutine vs Thread vs UniTask·Awaitable 비교
TL;DR (세 줄 요약)
- "1초 뒤에 실행"처럼 기다렸다가 하는 일을 만드는 방법은 여러 가지입니다. Coroutine, Thread, async/await는 모두 비동기처럼 보이지만 코드가 실행되는 위치가 다릅니다.
- Coroutine은 메인 스레드에서 실행됩니다. Unity가 매 프레임 이어서 실행해 주는 방식이라서 Unity API를 쓸 수 있지만, 동시에 실행되는 것은 아닙니다. Thread는 운영체제가 따로 돌리는 실행 흐름이라 실제로 동시에 실행되지만, Unity API는 메인 스레드에서만 쓸 수 있습니다.
- 프레임 타이밍과 Unity API가 필요하면 Coroutine이나 Awaitable/UniTask를 씁니다. CPU를 오래 쓰는 계산은 Job System과 Burst를 씁니다. 네트워크와 파일 작업을 이어 붙일 때는 UniTask나 Awaitable의 async/await를 씁니다.
이 글은 Unity C#에서 "기다렸다가 실행하기"와 "동시에 실행하기"를 만드는 방법들을 비교합니다. 비동기는 어떤 일이 끝나기를 그 자리에서 기다리지 않고, 다른 일을 먼저 하다가 나중에 이어서 처리하는 방식입니다. 코드는 설명을 위한 예제입니다.
1. 세 가지 방식은 실제로 무엇이 다른가요?

먼저 단어 두 개를 풀어 둡니다. 스레드(thread)는 프로그램 안에서 코드가 실행되는 흐름 하나입니다. 메인 스레드는 Unity가 게임 로직과 화면 그리기를 순서대로 처리하는 기본 흐름입니다.
| 방식 | 실행 위치 | 실제로 동시에 실행되나요? | Unity API |
| Coroutine | 메인 스레드. yield에서 멈추고, Unity가 나중에 이어서 실행합니다. | 아니요 | 쓸 수 있습니다. |
| Thread | 운영체제가 만드는 별도 실행 흐름 | 예. 여러 CPU 코어에서 동시에 실행됩니다. | 호출하면 예외가 납니다. |
| Job System | Unity가 관리하는 워커 스레드 | 예 | NativeArray 같은 네이티브 컨테이너의 데이터만 다룹니다. |
| Awaitable (Unity 2023.1 이상), UniTask | 기본은 메인 스레드. 필요하면 다른 스레드로 옮길 수 있습니다. | 옮겼을 때만 | 메인 스레드에 있을 때 쓸 수 있습니다. |
2. Coroutine은 어떻게 동작하나요?
Coroutine(코루틴)은 중간에 멈췄다가 나중에 이어서 실행할 수 있는 함수입니다. C#에서는 IEnumerator를 반환하고 안에서 yield return을 쓰는 메서드로 만듭니다.
컴파일러는 이런 메서드를 클래스 하나로 바꿉니다. 이 클래스는 지금 어디까지 실행했는지(state)를 필드로 기억합니다. 이렇게 현재 상태를 기억하고 상태에 따라 다른 일을 하는 구조를 상태 머신이라고 부릅니다.
IEnumerator Fade()
{
Debug.Log("start");
yield return null; // 다음 프레임에 여기서 이어서
Debug.Log("next frame");
}
// 컴파일러가 만드는 것(요약)
class Fade_d__0 : IEnumerator
{
int state;
public bool MoveNext()
{
switch (state)
{
case 0: Debug.Log("start"); state = 1; return true;
case 1: Debug.Log("next frame"); return false;
}
return false;
}
}
- 위쪽
Fade()가 우리가 쓰는 코드입니다.yield return null에서 멈추고 다음 프레임에 그 아래 줄부터 이어집니다. - 아래쪽 클래스는 컴파일러가 만들어 내는 코드를 줄여서 적은 것입니다.
MoveNext()를 부를 때마다state값에 따라 다음 구간을 실행합니다. MoveNext()가true를 돌려주면 아직 할 일이 남았다는 뜻이고,false면 끝났다는 뜻입니다.
Unity는 매 프레임 실행 중인 코루틴마다 MoveNext()를 불러 줍니다. 그래서 "1초 기다리기"를 반복문으로 CPU를 계속 쓰면서 기다리지 않고, 프레임마다 시간이 됐는지 확인하는 방식으로 처리합니다.
yield 뒤에 무엇을 쓰면 언제 다시 실행되나요?
| 코드 | 다시 실행되는 때 |
yield return null | 다음 프레임의 Update가 끝난 뒤 |
new WaitForEndOfFrame() | 그 프레임의 렌더링이 모두 끝난 뒤 |
new WaitForFixedUpdate() | 다음 FixedUpdate가 끝난 뒤 |
new WaitForSeconds(1f) | 지정한 시간 뒤. Time.timeScale의 영향을 받습니다. |
new WaitForSecondsRealtime(1f) | 실제 시간 기준으로 지정한 시간 뒤 |
new WaitUntil(() => 조건) | 조건이 참이 될 때 |
StartCoroutine(다른 코루틴) | 그 코루틴이 끝났을 때 |
Coroutine에는 어떤 비용이 있나요?
코루틴 하나를 시작할 때마다 상태 머신 객체가 힙에 생깁니다. 힙은 new로 만든 객체가 놓이는 메모리 영역입니다. 메서드의 지역 변수는 이 객체의 필드로 옮겨집니다. 다 쓴 객체는 가비지 컬렉터(GC)가 치워야 합니다. 그래서 코루틴을 매 프레임 새로 시작하면 GC가 치울 것이 계속 쌓입니다.
new WaitForSeconds(1f)도 객체를 만듭니다. 같은 시간을 반복해서 기다린다면 한 번만 만들어 두고 다시 씁니다.
// 매번 새로 만들지 않고 재사용한다
WaitForSeconds wait1s = new WaitForSeconds(1f);
IEnumerator Tick() { while (true) yield return wait1s; }
3. Thread는 어떻게 동작하나요?
Thread는 운영체제가 실행 순서를 정하는 실행 단위입니다. 스레드를 만들면 스택이라는 메모리 공간이 따로 잡힙니다. 크기는 플랫폼에 따라 다르고, Windows의 기본값은 1MB입니다. 운영체제는 각 스레드에 CPU 코어를 쓸 시간을 나누어 줍니다.
| 구분 | Thread | Coroutine |
| 누가 전환하나요? | 운영체제가 강제로 전환합니다. 이런 방식을 선점형이라고 부릅니다. | 실행 중인 코드가 yield로 스스로 양보합니다. 이런 방식을 협력형이라고 부릅니다. |
| 동시에 실행되나요? | 여러 코어에서 동시에 실행됩니다. | 한 번에 하나만 실행됩니다. |
Thread에서는 왜 Unity API를 못 쓰나요?
Transform, GameObject, 컴포넌트 같은 Unity 객체는 메인 스레드에서만 쓰도록 만들어져 있습니다. 다른 스레드(워커 스레드)에서 transform.position을 읽으면 예외가 납니다.
Vector3, Quaternion, Color는 값 타입 구조체입니다. Unity 객체를 건드리지 않고 값만 계산한다면 워커 스레드에서 써도 됩니다. Mathf의 수학 함수도 마찬가지입니다.
ConcurrentQueue<Action> mainQueue = new ConcurrentQueue<Action>();
Thread worker;
void Start()
{
worker = new Thread(() =>
{
int result = HeavyCalc(); // Unity API 없이 계산
mainQueue.Enqueue(() => label.text = result.ToString()); // 메인 스레드에서 실행할 일만 넘김
});
worker.IsBackground = true;
worker.Start();
}
void Update()
{
while (mainQueue.TryDequeue(out Action act)) act();
}
mainQueue: 메인 스레드에서 실행할 일을 담아 두는 큐입니다.ConcurrentQueue는 여러 스레드가 동시에 넣고 꺼내도 안전한 큐입니다.new Thread(() => { ... }): 새 스레드에서 실행할 코드를 넘겨 스레드를 만듭니다.HeavyCalc(): 워커 스레드에서는 Unity API 없이 계산만 합니다.mainQueue.Enqueue(...): 글자를 바꾸는 일은 Unity 객체를 건드리므로 직접 하지 않고 큐에 넣습니다.worker.IsBackground = true: 프로그램이 끝날 때 이 스레드가 남아서 종료를 막지 않게 합니다.Update(): 메인 스레드에서 매 프레임 큐를 확인하고, 들어 있는 일을 꺼내 실행합니다.
패턴은 하나입니다. 워커 스레드에서는 계산만 합니다. Unity 객체를 건드리는 코드는 큐에 넣어 메인 스레드에서 실행합니다.
매번 new Thread()로 스레드를 만드는 것보다 ThreadPool이나 Task를 쓰는 편이 낫습니다. 스레드를 만들 때마다 스택 메모리와 운영체제 자원을 쓰기 때문입니다. ThreadPool은 미리 만들어 둔 스레드를 돌려 쓰는 장치입니다.
4. 동기화는 왜 필요한가요?
두 스레드가 같은 변수를 동시에 읽고 쓰면 순서가 섞여 값이 사라질 수 있습니다. 예를 들어 counter++는 읽기, 더하기, 쓰기 세 단계입니다. 그 사이에 다른 스레드가 끼어들 수 있습니다. 이런 일을 막는 것을 동기화라고 부릅니다.
| 도구 | 하는 일 |
lock | 한 번에 한 스레드만 블록 안의 코드를 실행하게 합니다. 가장 간단한 방법입니다. |
| Mutex | 서로 다른 프로세스 사이에서도 쓸 수 있습니다. 같은 프로세스 안에서는 lock보다 느립니다. |
| Semaphore | 동시에 들어갈 수 있는 스레드의 수를 제한합니다. |
| Interlocked | 숫자를 1 늘리는 일처럼 원자 연산 한 번으로 끝나는 경우에 lock 없이 씁니다. 원자 연산은 중간에 끊기지 않고 한 번에 끝나는 연산입니다. |
5. Job System과 Burst는 무엇인가요?
Job System은 Unity가 관리하는 워커 스레드에 작업(Job)을 나누어 넣는 기능입니다. Job은 NativeArray 같은 네이티브 컨테이너와 값 타입 데이터만 다룹니다. 그래서 Unity 객체에 접근하는 문제가 생기지 않습니다. 안전 시스템은 두 Job이 같은 데이터에 동시에 쓰려는 실수를 찾아 오류로 알려 줍니다. Job의 실행 순서는 JobHandle로 의존 관계를 넘겨서 정합니다.
[BurstCompile]
struct WaveJob : IJobParallelFor
{
public float time;
public NativeArray<float3> verts;
public void Execute(int i)
{
float3 v = verts[i];
v.y = math.sin(v.x + time);
verts[i] = v;
}
}
void Update()
{
var job = new WaveJob { time = Time.time, verts = verts };
JobHandle h = job.Schedule(verts.Length, 64);
h.Complete();
}
struct WaveJob : IJobParallelFor: 배열의 각 칸을 여러 스레드가 나누어 처리하는 Job입니다.Execute(int i): i번째 칸 하나를 처리하는 함수입니다. 여기서는 꼭짓점의 높이(y)를 사인 함수 값으로 바꿉니다.job.Schedule(verts.Length, 64): 전체 길이만큼 작업을 예약합니다. 64는 한 스레드가 한 번에 맡는 묶음의 크기입니다.h.Complete(): Job이 모두 끝날 때까지 기다립니다.[BurstCompile]: 이 Job을 Burst로 컴파일하라는 표시입니다.
Burst는 이 C# 코드를 LLVM이라는 컴파일러 기술로 최적화된 네이티브 코드로 바꿉니다. 네이티브 코드는 CPU가 바로 실행하는 기계어 코드입니다. Burst는 SIMD 명령을 써서 여러 값을 한꺼번에 계산하므로 같은 계산을 더 빨리 끝낼 수 있습니다. 대신 float3 같은 Burst가 지원하는 타입과 NativeArray를 써야 합니다. 결과를 읽으려면 Complete()로 Job이 끝나기를 기다려야 합니다.
6. UniTask와 Awaitable은 무엇인가요?
async와 await는 C#의 비동기 문법입니다. await에서 멈췄다가 기다리던 일이 끝나면 그 아래 줄부터 이어서 실행합니다.
- Awaitable: Unity 2023.1부터 엔진에 들어 있는 타입입니다. 별도 설치 없이 async/await를 쓸 수 있습니다.
- UniTask: Cysharp가 만든 오픈소스 라이브러리입니다. Awaitable이 없는 이전 버전의 Unity에서도 쓸 수 있습니다. struct 기반이라 메모리 할당을 거의 하지 않고, 취소 토큰과
WhenAll같은 조합 기능을 제공합니다.
async Awaitable LoadAsync()
{
await SceneManager.LoadSceneAsync("Game"); // 씬 로드 대기
await Awaitable.NextFrameAsync(); // 한 프레임 대기
await Awaitable.BackgroundThreadAsync(); // 워커 스레드로
var data = HeavyCalc(); // 무거운 계산
await Awaitable.MainThreadAsync(); // 메인 스레드로 복귀
Apply(data); // Unity API 사용
}
await SceneManager.LoadSceneAsync("Game");: 씬 로드가 끝날 때까지 기다립니다.await Awaitable.NextFrameAsync();: 한 프레임을 기다립니다.await Awaitable.BackgroundThreadAsync();: 이 줄 아래부터는 백그라운드 스레드에서 실행됩니다. 무거운 계산을 여기서 합니다.await Awaitable.MainThreadAsync();: 다시 메인 스레드로 돌아옵니다. 이 아래에서는 Unity API를 쓸 수 있습니다.
// UniTask 예
async UniTaskVoid LoadAsync(CancellationToken ct)
{
UnityWebRequest req = await UnityWebRequest.Get(url).SendWebRequest().WithCancellation(ct);
string json = req.downloadHandler.text;
await UniTask.Delay(1000, cancellationToken: ct);
label.text = json;
}
CancellationToken ct: 취소 토큰입니다. 작업을 중간에 그만두라고 알리는 데 씁니다.UnityWebRequest.Get(url).SendWebRequest().WithCancellation(ct): 웹 요청을 보내고 끝날 때까지 기다립니다. 결과로 요청 객체가 돌아옵니다.req.downloadHandler.text: 받은 내용을 문자열로 읽습니다.UniTask.Delay(1000, cancellationToken: ct): 1000밀리초(1초)를 기다립니다.
표준 Task와는 무엇이 다른가요?
| 구분 | .NET Task | Awaitable |
| 메모리 할당 | Task를 반환하는 메서드를 부를 때마다 할당이 생깁니다. | 인스턴스를 풀에서 돌려 쓰기 때문에 보통 할당이 생기지 않습니다. |
| 이어서 실행되는 때 | 메인 스레드에서 호출했다면 다음 프레임의 Update 때 메인 스레드에서 이어집니다. | 기다리던 일이 끝난 시점에 바로 이어집니다. |
| 여러 번 await | 할 수 있습니다. | 한 인스턴스를 두 번 await하면 안 됩니다. |
Unity는 메인 스레드에서 호출한 Task도 메인 스레드에서 이어지게 해 둡니다. 그래서 세 가지 모두 메인 스레드에서 호출했다면 await 뒤에 Unity API를 쓸 수 있습니다. 차이는 할당과 이어지는 시점에 있습니다. UniTask도 Unity의 PlayerLoop 위에서 동작하므로 대부분의 기능이 메인 스레드에서 실행됩니다.
7. 무엇을 골라야 하나요?
- Unity API를 써야 하나요? 그렇다면 Coroutine 또는 UniTask/Awaitable을 씁니다.
- 프레임 단위 타이밍(애니메이션, 페이드, 순서대로 이어지는 연출)인가요? Coroutine이 가장 짧고 읽기 쉽습니다.
- 큰 배열을 여러 스레드로 나누어 계산하나요? Job System과 Burst를 씁니다.
- 네트워크, 파일 입출력과 여러 비동기 작업을 이어 붙이나요? UniTask/Awaitable을 씁니다.
- Unity와 상관없는 순수 계산이고 결과만 받으면 되나요? Task나 ThreadPool을 씁니다.
8. 자주 하는 실수는 무엇인가요?
- 매 프레임
StartCoroutine을 호출합니다. GC가 치울 객체가 쌓입니다. - 워커 스레드에서
transform,gameObject에 접근합니다. - CPU 코어 수보다 많은 스레드를 만들어 계산을 시킵니다. 스레드를 바꾸는 비용만 늘어납니다.
- 컴포넌트만 끄면(
enabled = false) 코루틴도 멈출 것이라고 생각합니다. 코루틴은 게임 오브젝트가 비활성화되거나 파괴될 때 멈춥니다. 컴포넌트만 끄면 계속 실행됩니다. async void를 씁니다. 호출한 쪽에서 예외를 잡을 수 없습니다.UniTaskVoid나async Awaitable을 씁니다.- 한 프레임을 넘기려고
yield return new WaitForSeconds(0)을 씁니다.yield return null을 쓰면 됩니다.
자주 묻는 질문 (FAQ)
Q1. 코루틴은 스레드인가요?
아닙니다. 코루틴은 메인 스레드에서 실행됩니다. yield에서 멈추면 Unity가 나중에 MoveNext()를 다시 불러 이어서 실행합니다. 동시에 실행되는 것이 아닙니다. 그래서 코루틴 하나가 무거운 반복문으로 1초를 쓰면 그동안 게임 전체가 멈춥니다.
Q2. 스레드에서 Unity API를 쓰면 왜 예외가 나나요?
Unity 객체의 내부 상태는 메인 스레드에서만 바뀌도록 설계되어 있기 때문입니다. 워커 스레드에서 Transform에 접근하면 "can only be called from the main thread"라는 내용의 UnityException이 납니다. 계산 결과를 큐에 넣고 Update에서 꺼내 실행하면 해결됩니다.
Q3. Unity 2023.1보다 낮은 버전에서 async/await를 편하게 쓰려면 어떻게 하나요?
UniTask 패키지를 씁니다. struct 기반이라 Task보다 할당이 적습니다. 취소(CancellationToken)와 프레임 대기(UniTask.Yield, DelayFrame) 기능을 제공합니다. UniTask가 공식으로 지원하는 가장 낮은 버전은 Unity 2018.4.13f1입니다.
수정 안내
이 글은 2026년 11월 22일에 사실 확인을 거쳐 다시 썼습니다. 고친 내용은 다음과 같습니다.
- 코루틴 비용을 설명하던 수치(yield 한 번에 약 37바이트, 1,000개에 약 6ms와 90 FPS, 10,000개에 약 75ms와 121 FPS, 100,000개에 814ms와 8.2 FPS)는 측정 방법과 출처를 확인할 수 없어 삭제했습니다. Burst가 "수 배~수십 배 빠르다"는 표현도 같은 이유로 삭제했습니다.
- 설명 문장이 코드 블록 안에 들어가 있던 두 곳을 바로잡았습니다.
- Awaitable 예제에서
.ToAwaitable()호출을 뺐습니다. Unity 문서의 예제처럼LoadSceneAsync의 결과를 바로await합니다. - UniTask 예제를 고쳤습니다. 웹 요청을
await하면 문자열이 아니라 요청 객체가 돌아오므로,downloadHandler.text로 문자열을 읽게 했습니다. - "표준 Task는 스레드 풀에서 이어질 수 있고 Awaitable과 UniTask만 메인 스레드에서 이어진다"는 설명을 Unity 문서에 맞게 고쳤습니다.
- "코루틴을 중지하지 않고 오브젝트를 파괴하면 상태 머신이 남는다"는 설명은 사실과 달라, 컴포넌트만 껐을 때 코루틴이 계속 실행된다는 내용으로 바꿨습니다.
- Job System이 "순서를 자동으로 맞춘다"를 "안전 시스템이 실수를 오류로 알려 주고, 순서는 JobHandle로 정한다"로 고쳤습니다. 스레드 스택 크기 "기본 1MB"는 Windows 기준이라고 밝혔습니다.
참고 자료
- Unity 매뉴얼: Coroutines
- Unity 스크립팅 API: Awaitable
- Unity 매뉴얼: Introduction to asynchronous programming with Awaitable
- Unity 매뉴얼: Awaitable completion and continuation
- GitHub: Cysharp/UniTask
같은 주제의 다른 글: [UE5 렌더링] 텍스처에서 디스플레이까지: 언리얼 색 파이프라인과 sRGB vs Linear, [게임 엔진 비교] Unity C# vs Unreal C++: 메모리 관리, GC, 성능, 생산성, [게임 개발 방법론] 게임 개발의 애자일·스크럼 도입 사례 3가지: 스타트업·대기업·분산팀, [게임 디자인 패턴] 옵저버 패턴: Unity C# vs Unreal C++ 구현과 UML 구조, [Unity] ML-Agents 강화학습 게임 AI: 관찰·행동·보상 설계와 학습 과정