Swift 작성하기
초기 응답
이 스킬이 특정 질문 없이 처음 호출되면, 다음만 응답하세요:
현대적인 Swift를, 언어가 의도한 방식으로 작성할 수 있도록 도와드릴 준비가 되었습니다.
사용자가 질문하기 전까지 다른 정보는 제공하지 마세요.
Swift 6.4까지의 최신 Swift를 언어가 의도한 방식으로 작성하는 방법입니다.
도구 체인 기준: Swift 6.3 (2026년 8월 기준 최신 릴리스). 여기 있는 모든 내용은 6.3에서 컴파일되며, ⚠ 표시가 있는 것은 아직 릴리스되지 않은 Swift 6.4 기능입니다. 동시성 지침은 Swift 6.2 모델을 기준으로 합니다. 프로젝트가 6.1 이하인 경우, §3의 async 및 @concurrent 관련 규칙은 적용되지 않습니다.
핵심 원칙: Swift는 점진적 공개 언어입니다. 가장 단순하고, 가장 정적이며, 가장 단일 스레드로 동작하는 것부터 시작하고, 이유를 명확히 설명할 수 있을 때만 동적 기능(동시성, 참조 의미론, 존재 타입, 안전하지 않은 포인터)을 구매하세요. 아래의 모든 규칙은 이 원칙을 적용한 것입니다.
이러한 기본값의 계층 구조를 모델링하세요. 이유를 명확히 설명할 수 있을 때만 한 단계 아래로 내려가세요:
| 필요 사항 | 기본 선택 | 다음 경우에만 아래로 이동 |
|---|---|---|
| 데이터 | struct / enum | 식별성, 공유, 상속이 필요할 때 |
| 추상화 | 구체 타입 | 타입 전체에 반복되는 코드가 있을 때 |
| 다형성 | some P (제네릭) | 이기종 저장이 필요할 때 → any P |
| 실행 | Main Actor, 동기 | 프로파일링에서 행(hang)이 나타날 때 → async → @concurrent → actor |
| 메모리 | Array, String | 프로파일링에서 비용이 확인될 때 → InlineArray, Span |
| 안전성 | 안전한 API | C 상호 운용 또는 측정된 핫 경로일 때 → Unsafe* |
1. 값 타입으로 데이터 모델링
값 타입은 Swift에서 특별한 경우가 아니라 기본값입니다.
- 기본적으로
struct와enum을 사용하세요.class는 식별성, 공유 가변 상태, 상속, 또는 리소스 수명에만 사용하세요. 윈도우, 데이터베이스 연결, 렌더링 엔진에 저장된 엔티티는 식별성을 가집니다.Point,Drink,Material은 그렇지 않습니다. - 기본적으로
let을 사용하고, 변경할 때만var를 사용하세요. 이는any보다some을, 참조보다 값을 먼저 사용하는 규율과 같습니다: 좁게 시작하고, 이유가 있을 때만 넓히세요. - 가변 참조 타입 프로퍼티를 가진 구조체는 값도 아니고 참조도 아닙니다. 복사본이 객체를 공유하며, 변경 사항이 복사본 간에 누출됩니다. 참조된 타입을 불변으로 유지하거나, 해당 타입으로 전달하는 계산된 프로퍼티만 노출하거나, 복사-시-쓰기 뒤에
private저장 프로퍼티로 만드세요. - 복사-시-쓰기는 대역 외 저장과 값 의미론을 함께 얻는 방법입니다. 구조체에서
final클래스를 래핑하고 변경 전에isKnownUniquelyReferenced(&storage)를 확인하세요. 고유하지 않으면 먼저 복사합니다. 이것이 정확히Array,String,Dictionary가 작동하는 방식입니다. - 열거형은 "고정된 것들의 집합"과 상호 배타적인 상태를 위한 도구입니다. 여러 개의 옵셔널 저장 프로퍼티(
isSharing,selectedRows,shareTarget)를 하나의enum State로 대체하면 유효하지 않은 조합을 표현 불가능하게 만들고, 상태 변경을 잊어버릴 수 있는 일련의 프로퍼티 쓰기가 아닌 원자적 작업으로 만듭니다. - 값을 구성하면 값이 생성됩니다. 저장 프로퍼티가 모두 값 타입인 구조체는 값 의미론을 자동으로 가지며, 이는 실행 취소, diff, 상태 복원을 프로퍼티별 코드 경로가 아닌 단일 코드 경로로 만듭니다.
struct Material { // 값 의미론 유지
var roughness: Double
private var _texture: Texture // 클래스
var color: Color {
get { _texture.color }
set {
if !isKnownUniquelyReferenced(&_texture) { _texture = Texture(copying: _texture) }
_texture.color = newValue
}
}
}
비복사 타입(~Copyable)은 고유 소유권을 표현합니다: 파일 디스크립터, 은행 송금, 열린 리소스. 복사를 억제하면 "이것을 두 번 실행하지 마라"는 단언(assertion)에서 컴파일 오류가 되고, 구조체에서 deinit이 의미를 갖게 됩니다. 완료 메서드를 consuming으로 표시하여 컴파일러가 마지막 사용임을 증명하도록 하세요. 매개변수 소유권이 명시적이 됩니다: borrowing(읽기 전용, 기본값), consuming(가져감), inout/mutating(임시 쓰기 접근).
2. 오류와 옵셔널 — 실패 경로를 보이게 만드세요
Swift 오류 처리는 세 가지에 기반합니다: 오류의 원인이 표시되어 놀라게 하지 않으며, 오류는 조치를 취할 수 있는 충분한 컨텍스트를 전달하며, 복구 가능한 오류는 프로그래머 실수와 다릅니다.
- 복구 가능 →
throw. 프로그래머 실수 →precondition/fatalError. 실패한 네트워크 호출은 프로그램을 계속 실행합니다. 범위를 벗어난 인덱스는 코드가 잘못되었으며 버그가 보안 문제가 되기 전에 중단되어야 함을 의미합니다. - 연관 값을 가진 열거형이 최상의 오류 타입입니다.
case duplicateFriend(String)이case duplicateFriend보다 낫습니다. 컨텍스트가 핵심입니다. - 오류 조건에는
guard를 사용하세요. 종료 경로를 강제하기 때문입니다. 일반적인 언래핑에는if let을 사용하세요. - 타입이 있는 throws(
throws(MyError))는 내부 함수, 오류 전달 제네릭 코드, 제약된 환경을 위한 것입니다.any Error박싱 비용이 너무 클 때 사용하세요. 공개 API의 경우, 타입이 없는throws는 나중에 오류 타입을 변경할 자유를 보존합니다. 통일성 참고:throws는throws(any Error)이고, 던지지 않는 것은throws(Never)입니다. 이것이map이 둘 다 추상화할 수 있게 하는 이유입니다. - 강제 언래핑은 불변 조건을 명시할 수 있는 경우에만 사용하고, 단순한
!보다 메시지가 있는#require/precondition을 선호하세요.
3. 동시성: 프로파일링이 말하기 전까지 단일 스레드 유지
이 부분은 에이전트가 가장 자주 틀리는 섹션입니다. Swift 6.2에서 모델이 변경되었기 때문입니다.
모든 앱을 완전히 메인 스레드에서 시작하세요. 단일 스레드 코드는 많은 부분을 처리할 수 있으며, 대부분의 앱은 절대 단일 스레드를 벗어날 필요가 없습니다.
순서대로 진행하세요. 단계를 건너뛰지 마세요.
- Main Actor에서 단일 스레드. 동시성 전혀 없음. 대부분의 앱에 충분합니다.
async/await대기 시간(네트워크, 디스크)을 숨기기 위해. 여전히 자체 동시성은 없습니다.URLSession.data(from:)과 같은 SDK API가 대신 오프로드합니다.@concurrent자신의 비용이 많이 드는 작업을 메인 스레드에서 이동 — Instruments가 행(hang)을 보여준 후에만.actor_상태_를 Main Actor에서 이동 — 너무 많은 Main Actor 상태가 작업을 계속 다시 이동하도록 강제할 때만.
먼저 올바른 빌드 설정을 켜세요. 모든 프로젝트에서 접근 가능한 동시성(Approachable Concurrency) 을 활성화하세요. 앱 모듈 및 UI 관련 모듈의 경우 기본 Actor 격리(Default Actor Isolation) 를 MainActor로 설정하세요. Xcode 26의 새 앱 프로젝트에서는 기본값이며, 대부분의 @MainActor 어노테이션을 없앱니다. 패키지에서는: swiftSettings: [.defaultIsolation(MainActor.self)]. 범용 라이브러리에는 MainActor 기본을 설정하지 마세요. 라이브러리는 nonisolated API를 제공하고 클라이언트가 작업을 실행할 위치를 결정하도록 해야 합니다.
변경된 규칙
Swift 6.2에서 함수를 async로 표시해도 현재 Actor에서 이동하지 않습니다. 호출된 곳에서 실행됩니다. 이것이 "가장 자연스러운 코드를 작성하는 것"이 기본적으로 데이터 레이스로부터 자유롭게 만드는 이유입니다.
@concurrent— 항상 동시 스레드 풀로 전환합니다. 자신의 CPU 집약적 작업에 사용하세요.nonisolated— 호출된 곳에서 실행됩니다. 라이브러리 API의 올바른 기본값입니다. 호출자가 결정하기 때문입니다. 타입에nonisolated를 사용하면 모든 멤버가 nonisolated가 됩니다(Swift 6.1+).- 둘 다 아님 — 호출자의 Actor에 남습니다.
nonisolated struct PhotoProcessor { // Main Actor로부터 분리
@concurrent // 백그라운드에서 실행됨이 보장됨
func process(_ data: Data) async -> ProcessedPhoto {
async let sticker = extractSticker(data) // 두 개의 독립적인 작업, 병렬로
async let colors = extractColors(data)
return await ProcessedPhoto(sticker: sticker, colors: colors)
}
}
- 오프로드하기 전에 프로파일링하세요. Instruments(Time Profiler, hangs)를 사용하세요. 동시성 없이 코드를 더 빠르게 만들 수 있다면 항상 먼저 그렇게 하세요. 동시성에는 실제 비용이 있습니다 — 작업 할당, 스케줄링, 추론.
- 사소한 작업을 위해 태스크를 생성하지 마세요.
UserDefaults값을 읽기 위한 하위 태스크는 절약하는 것보다 더 많은 비용이 듭니다. - 종단 간 작업당 하나의 태스크. 순서대로 발생해야 하는 작업은 하나의 태스크에 넣고, 독립적인 작업은 별도의 태스크로 만들어 런타임이 인터리브할 수 있게 하세요.
await는 중단 지점이며, 원자성을 깨뜨립니다. 중단된 동안 상태가 변경될 수 있으며, 다른 스레드에서 재개될 수 있습니다. 모든await후에 가정을 다시 확인하세요.await를 가로질러 락을 보유하지 마세요.await를 가로질러 스레드 로컬 저장소에 의존하지 마세요.
Actor 재진입
Actor는 상호 배제를 보장하지만 트랜잭션은 보장하지 않습니다. 동일한 Actor의 두 await 사이에 다른 작업이 실행됩니다.
- 동기 메서드에서 Actor 상태를 변경하세요. Actor의 동기 코드는 중단 없이 완료될 때까지 실행됩니다. 이것이 트랜잭션 경계입니다.
- async Actor 메서드를 얇게 유지하고, 동기 트랜잭션 작업으로 구성하며, 모든
await에서 Actor를 일관된 상태로 남겨두세요. - 고전적인 버그: 캐시 확인 →
await다운로드 → 캐시 쓰기. 두 작업 모두 캐시 미스, 둘 다 다운로드, 두 번째가 첫 번째를 덮어씁니다.await후에 다시 확인하거나, 진행 중인 작업을 중복 제거하세요. - Actor는 FIFO가 아닙니다. 우선 순위 역전을 방지하기 위해 가장 높은 우선 순위 작업을 먼저 실행합니다. 순서가 필요하다면 태스크(처음부터 끝까지 실행됨) 또는
AsyncStream을 사용하고, Actor는 사용하지 마세요.
4. Sendable 및 데이터 공유
Sendable은 격리 도메인 간에 공유해도 안전한 타입을 표시합니다. 컴파일러는 모든 태스크 및 Actor 경계에서 이를 확인합니다.
- 값 타입은 저장소가
Sendable할 때Sendable합니다 — 공개되지 않은 타입은 자동으로 추론됩니다. 공개 타입은 절대 sendability가 추론되지 않습니다. 공개 타입을Sendable로 표시하는 것은 클라이언트에 대한 약속이므로, Swift가 이를 직접 작성하도록 요구합니다. - Actor와
@MainActor클래스는 암시적으로Sendable합니다. 상태가 격리되어 있기 때문입니다. - 대부분의 모델 클래스는
@MainActor도Sendable도 아니어야 합니다. 의도적으로 non-Sendable로 유지하세요. 모델의 절반이 메인 스레드에서 변경되고 나머지 절반이 백그라운드에서 변경되는 것을 방지합니다. Main Actor를 벗어나야 한다면Sendable이 아닌nonisolated로 만드세요. - 발신자가 사용을 중단하는 한 non-
Sendable객체를 도메인 간에 보낼 수 있습니다. 모든 변경을 전달하기 전에 수행하세요. 이후에 만지는 것이 오류입니다. - 클로저도 상태를 캡처합니다. 함수 타입이 실제로 도메인을 가로지르는 경우에만
@Sendable로 표시하세요. @unchecked Sendable은 컴파일러가 확인할 수 없는 약속입니다. 실제 내부 동기화(Mutex, 락)가 있는 타입을 위해 남겨두세요. 전역 변수에nonisolated(unsafe)를 사용하는 것도 마찬가지입니다 — 최후의 수단이지 경고 음소거기가 아닙니다.
데이터 레이스 오류가 발생하면 이 목록을 따라 작업하세요:
- 공유하지 마세요. 공유 객체를 로컬로 이동하여 각 동시 작업이 자체 인스턴스를 가지게 하세요. (이것이 실제 오류의 압도적 다수를 해결하는 방법입니다.)
Sendable값 타입으로 만드세요. "공유"가 실제로는 복사가 되도록.- Actor로 격리하세요. Main Actor 또는 자체 Actor.
- 그런 다음에만
Synchronization모듈의Mutex/Atomic(이것들을let프로퍼티에 저장) 또는@unchecked Sendable에 손을 대세요.
전역 및 정적 변수는 가장 일반적인 오류 원인입니다. 선호도 순서: let으로 만드세요. @MainActor에 넣으세요. Mutex로 감싸세요. nonisolated(unsafe). Swift의 전역 변수는 C와 달리 지연 및 원자적으로 초기화됩니다.
이전 콜백 API 연결: 소유한 경우 델리게이트 프로토콜에 @MainActor를 어노테이션하세요. 그렇지 않으면 메서드를 nonisolated로 표시하고 MainActor.assumeIsolated { }를 사용하세요. 이는 건너뛰는 대신 단언하며, 조용히 경쟁하는 대신 큰 소리로 트랩합니다. 적합성에 @preconcurrency를 사용하는 것은 같은 것의 줄임말입니다. @preconcurrency import를 사용하여 마이그레이션되지 않은 모듈의 sendability 경고를 일시적으로 침묵시키세요. 경고는 해당 모듈이 마이그레이션되면 올바르게 다시 나타납니다.
5. 구조적 동시성
항상 구조적 태스크를 선호하세요.
구조적 태스크(async let, 태스크 그룹)는 지역 변수처럼 범위가 지정됩니다: 블록보다 오래 지속될 수 없고, 자동으로 대기되며, 취소, 우선 순위, 태스크 로컬 값을 태스크 트리를 통해 상속합니다. 비구조적 태스크(Task { }, Task.detached)는 이러한 것들을 자동으로 제공하지 않습니다.
async let고정되고 정적으로 알려진 수의 동시 하위 작업에 사용.withTaskGroup수가 동적일 때 사용. 태스크 그룹은AsyncSequence를 준수합니다 — 결과가 도착하면 반복하세요. 하위 작업이 아무것도 반환하지 않을 때는 **withDiscardingTaskGroup**을 사용하세요. 각 하위 작업의 리소스를 즉시 해제하고 첫 번째 오류 시 형제 작업을 취소합니다.Task { }작업의 수명이 범위에 맞지 않을 때만 사용 — 델리게이트 콜백, 버튼 탭, 뷰 표시에 반응할 때. Actor 격리와 우선 순위를 상속하며, 취소를 직접 관리해야 합니다.- **
Task.detached**는 거의 사용하지 마세요. 아무것도 상속하지 않습니다 — 격리, 우선 순위, 태스크 로컬 값. 분리된 루트가 필요하다면 반복적으로 분리하는 대신 내부에 태스크 그룹을 넣으세요.
취소는 협력적입니다. 취소는 플래그를 설정합니다. 아무것도 중단하지 않습니다. 비용이 많이 드는 작업을 시작하기 전에 Task.isCancelled 또는 try Task.checkCancellation()을 확인하세요. 동기 헬퍼에서도 마찬가지입니다. 실행 중이 아니라 일시 중단된 작업(AsyncSequence의 next())의 경우 withTaskCancellationHandler를 사용하세요. 핸들러는 본문과 동시에 즉시 실행되므로, 핸들러가 접촉하는 상태는 실제 동기화(원자적 또는 락, Actor는 아님 — Actor에서 순서를 보장할 수 없음)가 필요합니다.
동시성을 제한하세요. 항목당 하나의 하위 작업을 무제한 목록에 펼치지 마세요. N개의 하위 작업을 시작한 다음, 나머지를 추가하세요.
6. 프로토콜과 제네릭 — some vs any
some과 any는 같은 것을 말하지 않습니다.
-
some P— 구체적이지만 불투명합니다. 컴파일러는 단 하나의 구체 타입을 봅니다(호출당). 함수 본문을 특수화할 수 있고, 레이아웃을 알고 있으며, 메서드에 정적으로 디스패치할 수 있습니다. 반환 타입이some P인 함수가 그렇습니다. -
any P— 상자에 넣습니다. 타입 지우기. 모든P값을 저장할 수 있습니다.any P값이 존재 타입 상자에 들어가며, 각 메서드 호출은 동적 디스패치를 사용합니다.any P는some과 달리 이기종 컬렉션([any Hashable])과 여러 구체 타입이 필요한 저장소(AnyView,any ShapeStyle)를 가능하게 합니다. -
기본적으로
some을 사용하고, 이기종 컬렉션, 저장소, 또는 서로 다른 구체 타입이 반환값을 변경할 때만any를 사용하세요. -
**함수 매개변수에서
any P는 프로토콜 타입 매개변수를 의미하고some P``는 제네릭을 의미합니다.** 이것은 정확히 동일하지 않습니다.some P는 호출 사이트가 구체 타입을 결정하도록 합니다.any P는 인수를 상자에 넣도록 합니다. 가능하면some을 사용하세요. 호출자가 선택한다는 점에서nonisolated`와 유사합니다. -
any가 값 의미론인 경우any로 캡슐화를 얻을 수 있습니다. 상자 자체가 값 타입인 경우(복사 가능, 동등성 등)any값은 값 의미론을 가질 수 있습니다.any Error가 그 예입니다.any View는 iOS 18/Xcode 26 이전까지는 그렇지 않으며, 이후에는 프로토콜이~Copyable이 됩니다.
7. API 설계 — 당신의 API는 약속입니다
- 기본 구현이 없는 프로토콜의 메서드를
public으로 표시하지 마세요. 사용자가 준수해야 하는 메서드만 공개하세요. - 저장 프로퍼티를
public으로 절대 만들지 마세요. 항상 비공개로 유지하고 필요한 경우 계산된 getter를 제공하세요. - 프로토콜 요구사항에 기본값이 있는 경우
optional대신 기본 구현을 사용하세요. - 매개변수는 가능한 가장 덜 제한적인 타입을 받으세요. 예:
[String]대신some Sequence<String>. - 모든
public선언에 문서화 주석을 작성하세요.///스타일을 사용하세요. @available을 사용하여 플랫폼 및 Swift 버전을 표시하세요.- 폐기 예정인 API에는
@available(*, deprecated, renamed: "newName")를 사용하세요.
8. 성능 및 ARC
Swift의 ARC는 참조 타입의 수명을 관리하지만, 때때로 예상치 못한 보유 주기를 생성할 수 있습니다.
- 순환 참조는
[weak self]또는[unowned self]로 끊으세요.[weak self]를 선호하세요. 약한 참조는 자동으로 nil이 될 수 있습니다. 소유되지 않은 참조는 객체가 해제된 후 nil이 될 수 없습니다. - 클로저가 캡처하는 객체의 수명과 일치하지 않을 때 보유 주기가 발생합니다. 객체 내부의 클로저가 객체를 다시 참조하면 주기가 생성됩니다.
- 구조체가 값을 변경할 때 불필요한 복사를 피하세요. 특히 컬렉션에서. 성능에 민감한 코드에서는 복사-시-쓰기를 사용하세요.
final클래스는 상속 불가를 통해 가상 디스패치를 제거하여 더 나은 성능을 제공합니다. 특히 성능이 중요한 코드에서 클래스를final로 표시하는 것을 고려하세요.
9. Swift Testing
Swift Testing은 XCTest를 대체하는 현대적인 테스트 프레임워크입니다.
import Testing을 사용하세요.- 테스트 함수는
@Test로 표시하고, 테스트 인수는#expect매크로를 사용하세요. #expect는 조건을 테스트하고, 실패 시 진단을 제공합니다.await와 같은 비동기 코드를 테스트하려면@Test함수를 비동기로 표시하세요.@Suite를 사용하여 관련 테스트를 그룹화하세요.@Test(.disabled("이유"))로 테스트를 비활성화하세요.#expect(throws:)를 사용하여 던져지는 오류를 테스트하세요.#expect는 사용자 정의 실패 메시지를 위해comment:매개변수를 지원합니다.
10. 매크로
매크로는 컴파일 시간에 코드를 생성합니다.
#Preview매크로는 뷰 인스턴스를 생성하여 빠른 시각적 미리보기를 제공합니다.#Predicate매크로는Predicate를 생성합니다.#require매크로는 조건이 충족되지 않으면 현재 함수를 종료합니다.guard가 트리거되면 실패를 기록합니다.- 사용자 정의 매크로는 컴파일 시간에 코드를 생성할 수 있습니다. 자세한 내용은 Swift Evolution SE-0389를 참조하세요.
Swift의 진화
Swift는 빠르게 진화하고 있습니다. 에이전트는 최신 Swift Evolution 제안을 최신 상태로 유지해야 합니다.
- Swift 6.2의
@concurrent및nonisolated기본값 — async는 더 이상 현재 Actor를 떠나지 않습니다. ~Copyable타입 — 고유 소유권을 위한 비복사 타입.- 접근 가능한 동시성 — Swift 6.2의
@concurrent및nonisolated기본값. - 매크로 —
#Preview,#Predicate,#require. - Swift Testing — XCTest를 대체하는 현대적인 테스트 프레임워크.
some및any— 프로토콜 타입 매개변수에 대한 명확한 의미.- 소유권 매개변수 —
borrowing,consuming,mutating/inout. Actor재진입 및 비-FIFO 순서.@unchecked Sendable및nonisolated(unsafe)— 신중하게 사용하세요.
요약
Swift는 점진적 공개 언어입니다.
기본값으로 시작하고, 이유가 있을 때만 움직이세요.
- 데이터 →
struct/enum - 추상화 → 구체 타입 →
some P→any P - 실행 → 단일 스레드 →
async→@concurrent→actor - 메모리 →
Array/String→InlineArray/Span - 안전성 → 안전한 API →
Unsafe*
그리고 항상 프로파일링하세요. 정말로 거기에 도달할 필요가 없다면 최적화하지 마세요.
이 스킬은 Swift 6.3을 기준으로 작성되었습니다. Swift 6.4의 일부 기능은 ⚠로 표시되어 있습니다.