用途
本技能为 Swift 并发系统提供专业指导,内容基于 Fucking Approachable Swift Concurrency 的心智模型。当你在使用 async/await、Task、actor、MainActor、Sendable、隔离域,或调试并发相关问题时,可以借助本技能获得概念解释与写法建议。
核心心智模型:办公楼
把应用想象成一栋办公楼,隔离域就是带锁的私人办公室:
- MainActor = 前台(处理所有 UI 交互,只存在一个)
- actor 类型 = 部门办公室(财务、法务、人力——各自保护自己的数据)
- nonisolated 代码 = 走廊(共享空间,没有私密文件)
- Sendable 类型 = 复印件(可在办公室之间安全共享)
- 非 Sendable 类型 = 原件(必须留在某一个办公室内)
你不能闯进别人的办公室,需要先敲门(await)然后等待。
主要能力
Async/Await
异步函数可以暂停,使用 await 挂起直到工作完成:
func fetchUser(id: Int) async throws -> User {
let (data, _) = try await URLSession.shared.data(from: url)
return try JSONDecoder().decode(User.self, from: data)
}
并行工作可使用 async let:
async let avatar = fetchImage("avatar.jpg")
async let banner = fetchImage("banner.jpg")
return Profile(avatar: try await avatar, banner: try await banner)
Tasks
Task 是可以管理的异步工作单元:
// SwiftUI - 视图消失时取消
.task { avatar = await downloadAvatar() }
// 手动创建任务
Task { await saveProfile() }
// 使用 TaskGroup 并行工作
try await withThrowingTaskGroup(of: Void.self) { group in
group.addTask { avatar = try await downloadAvatar() }
group.addTask { bio = try await fetchBio() }
try await group.waitForAll()
}
组内的子任务:取消会传播,错误会取消兄弟任务,并等待全部完成。
隔离域
Swift 问的是“谁可以访问这份数据”,而不是“哪个线程”。共有三个隔离域:
- MainActor:用于 UI,所有与 UI 相关的内容都应放在这里。
@MainActor
class ViewModel {
var items: [Item] = [] // 由 MainActor 保护
}
- Actors:通过独占访问保护自身可变状态。
actor BankAccount {
var balance: Double = 0
func deposit(_ amount: Double) { balance += amount }
}
await account.deposit(100) // 从外部调用必须 await
- Nonisolated:选择退出 actor 隔离,不能访问 actor 的受保护状态。
actor BankAccount {
nonisolated func bankName() -> String { "Acme Bank" }
}
let name = account.bankName() // 无需 await
Approachable Concurrency(Swift 6.2+)
两个构建设置可简化心智模型:
SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor:除非另有说明,一切都在 MainActor 上运行SWIFT_APPROACHABLE_CONCURRENCY = YES:nonisolated 异步函数停留在调用者的 actor 上
// 在 MainActor 上运行(默认)
func updateUI() async { }
// 在后台运行(需显式选择)
@concurrent func processLargeFile() async { }
Sendable
标记类型可以安全跨越隔离边界传递:
// Sendable - 值类型,每份各得一份拷贝
struct User: Sendable {
let id: Int
let name: String
}
// 非 Sendable - 可变类状态
class Counter {
var count = 0
}
自动 Sendable 的情况:属性都是 Sendable 的结构体/枚举;actor(保护自身状态);@MainActor 类型(MainActor 串行化访问)。
对于内部同步的线程安全类:
final class ThreadSafeCache: @unchecked Sendable {
private let lock = NSLock()
private var storage: [String: Data] = [:]
}
使用方式
隔离继承
在 Approachable Concurrency 下,隔离会从 MainActor 沿代码流动:
- 函数:除非显式标记,否则继承调用者的隔离
- 闭包:从定义处的上下文继承
Task { }:从创建位置继承 actor 隔离Task.detached { }:不继承(很少需要)
在异步工具中保留隔离
编写接受闭包的泛型异步函数时,需要保留调用者的隔离以避免 Sendable 错误。
方式一:nonisolated(nonsending)(更简单)
// 停留在调用者的执行器上,无需 Sendable
nonisolated(nonsending)
func measure<T>(_ label: String, block: () async throws -> T) async rethrows -> T
方式二:#isolation 参数(需要访问 actor 时)
// 显式隔离参数,便于传递
func measure<T>(
isolation: isolated (any Actor)? = #isolation,
_ label: String,
block: () async throws -> T
) async rethrows -> T
默认使用 nonisolated(nonsending);需要显式访问 actor 实例时使用 #isolation。
常见错误
- 认为 async = 后台:
@MainActor func slowFunction() async { let result = expensiveCalculation() }仍会阻塞主线程(同步即阻塞),CPU 密集工作应使用@concurrent。 - 创建过多 actor:大多数东西可以留在 MainActor,只有当存在无法放到 MainActor 的共享可变状态时才创建 actor。
- 把所有东西都设为 Sendable:并非一切都需跨越边界,先问数据是否真的在隔离域之间移动。
- 不必要地使用
MainActor.run:可改为给函数加@MainActor标注。 - 阻塞协作线程池:不要在异步代码中使用
DispatchSemaphore、DispatchGroup.wait(),有死锁风险。 - 创建不必要的 Task:优先使用
async let等结构化并发而非非结构化Task { }。
快速参考
| 关键字 | 用途 |
|---|---|
| async | 函数可以暂停 |
| await | 在此暂停直到完成 |
| Task { } | 启动异步工作,继承上下文 |
| Task.detached { } | 启动异步工作,无上下文 |
| @MainActor | 在主线程运行 |
| actor | 拥有被隔离可变状态的类型 |
| nonisolated | 选择退出 actor 隔离 |
| nonisolated(nonsending) | 停留在调用者的执行器上 |
| Sendable | 可在隔离域之间安全传递 |
| @concurrent | 始终在后台运行(Swift 6.2+) |
| #isolation | 将调用者的隔离捕获为参数 |
| async let | 启动并行工作 |
| TaskGroup | 动态并行工作 |
适用场景
- 编写或审查使用 async/await、Task、TaskGroup 的 Swift 并发代码
- 定义和使用 actor、MainActor、nonisolated 成员
- 处理 Sendable 相关编译错误与隔离域传递问题
- 采用 Swift 6.2+ Approachable Concurrency 构建设置进行迁移或调优
- 编写保留调用者隔离的泛型异步工具函数
- 排查并发相关的编译告警、数据竞争与阻塞问题
限制
- 编译器报错时的排查思路:追踪隔离来源、代码运行位置、跨越边界的数据;一旦问对问题,答案通常显而易见
- 本技能未提供收费、价格、平台支持范围等商业信息,资料中暂未提供
延伸阅读
- Matt Massicotte 的博客(这些心智模型的来源)
- Swift Concurrency 官方文档
- WWDC21: Meet async/await
- WWDC21: Protect mutable state with actors