http://yeniful.github.io/tags/swift-concurrency/Recent content in Swift Concurrency on @yeniful blogHugo -- 0.155.3en-usFri, 30 Jan 2026 00:00:00 +0900http://yeniful.github.io/posts/2026/swift-mainactor/Fri, 30 Jan 2026 00:00:00 +0900http://yeniful.github.io/posts/2026/swift-mainactor/<h2 id="motivation">Motivation</h2> <p>iOS 개발에서 UI 업데이트는 <strong>반드시 메인 스레드</strong>에서 해야 하지만, Swift Concurrency 도입 후 백그라운드 Task 내에서 UI를 직접 업데이트하는 실수가 쉬워졌다. @MainActor는 컴파일 타임부터 이 문제를 구조적으로 해결해 준다. 이 글에서 MainActor에 대해 다뤄보려고 한다.</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-Swift" data-lang="Swift"><span style="display:flex;"><span>Task { <span style="color:#75715e">// 백그라운드 Task (Global Actor)</span> </span></span><span style="display:flex;"><span> <span style="color:#66d9ef">let</span> data = await fetchUser() </span></span><span style="display:flex;"><span> userNameLabel.text = data.name <span style="color:#75715e">// UI 업데이트 (MainActor 필요!)</span> </span></span><span style="display:flex;"><span>} </span></span></code></pre></div><h2 id="overview">Overview</h2> <h2 id="1-mainactor는-언제-필요할까-문제-상황">1. MainActor는 언제 필요할까? (문제 상황)</h2> <h3 id="1-1-uikit의-메인-스레드-제약">1-1. UIKit의 메인 스레드 제약</h3> <h3 id="1-2-gcd의-한계-dispatchqueuemainasync">1-2. GCD의 한계 (DispatchQueue.main.async)</h3> <h3 id="1-3-swift-concurrency의-함정-task--ui-섞기">1-3. Swift Concurrency의 함정 (Task + UI 섞기)</h3> <h2 id="2-mainactor-기본-개념">2. MainActor 기본 개념</h2> <h3 id="2-1-mainactor-알기-전-actor가-무엇인지">2-1. MainActor 알기 전 Actor가 무엇인지</h3> <h3 id="2-2-global-actor와-mainactor">2-2. Global Actor와 MainActor</h3> <h3 id="2-3-mainactor-속성의-의미">2-3. <code>@MainActor</code> 속성의 의미</h3> <h2 id="3-사용법">3. 사용법</h2> <h3 id="3-1-함수프로퍼티에-적용">3-1. 함수/프로퍼티에 적용</h3> <h3 id="3-2-클래스-전체에-적용-viewmodel-패턴">3-2. 클래스 전체에 적용 (ViewModel 패턴)</h3> <h3 id="3-3-swiftui와의-완벽-호환-published">3-3. SwiftUI와의 완벽 호환 (@Published)</h3> <h2 id="4-task와-함께-사용">4. Task와 함께 사용</h2> <h3 id="4-1-task--mainactor-in-">4-1. <code>Task { @MainActor in }</code></h3> <h3 id="4-2-await-mainactorrun--">4-2. <code>await MainActor.run { }</code></h3> <h3 id="4-3-taskdetached--mainactor-전환">4-3. <code>Task.detached</code> + MainActor 전환</h3> <h2 id="5-더-알아보기">5. 더 알아보기</h2> <h3 id="5-1-nonisolated-탈출구">5-1. <code>nonisolated</code> 탈출구</h3> <h3 id="5-2-sendable과-데이터-전달">5-2. <code>@Sendable</code>과 데이터 전달</h3> <h3 id="5-3-mainactor-호핑-최적화">5-3. MainActor 호핑 최적화</h3> <h2 id="6-mainactor와-dispatchqueue-비교">6. MainActor와 DispatchQueue 비교</h2> <h3 id="6-1-mainactor-vs-dispatchqueuemain">6-1. <code>@MainActor</code> vs <code>DispatchQueue.main</code></h3> <h3 id="6-2-다른-글로벌-액터와-비교">6-2. 다른 글로벌 액터와 비교</h3> <h3 id="references-">References 👀</h3>