SuperAPI AI 工具集

swift-concurrency

编程与开发

查看项目

更新于 10-16 07:43

技能介绍

用途

本技能为 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 问的是“谁可以访问这份数据”,而不是“哪个线程”。共有三个隔离域:

  1. MainActor:用于 UI,所有与 UI 相关的内容都应放在这里。
@MainActor
class ViewModel {
    var items: [Item] = []  // 由 MainActor 保护
}
  1. Actors:通过独占访问保护自身可变状态。
actor BankAccount {
    var balance: Double = 0
    func deposit(_ amount: Double) { balance += amount }
}

await account.deposit(100)  // 从外部调用必须 await
  1. 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。

常见错误

  1. 认为 async = 后台:@MainActor func slowFunction() async { let result = expensiveCalculation() } 仍会阻塞主线程(同步即阻塞),CPU 密集工作应使用 @concurrent。
  2. 创建过多 actor:大多数东西可以留在 MainActor,只有当存在无法放到 MainActor 的共享可变状态时才创建 actor。
  3. 把所有东西都设为 Sendable:并非一切都需跨越边界,先问数据是否真的在隔离域之间移动。
  4. 不必要地使用 MainActor.run:可改为给函数加 @MainActor 标注。
  5. 阻塞协作线程池:不要在异步代码中使用 DispatchSemaphore、DispatchGroup.wait(),有死锁风险。
  6. 创建不必要的 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