Swift Global Actor 完全指南

原文:Global actor in Swift Concurrency explained with code examples -- SwiftLee

什么是 Global Actor?

概念 一句话解释
Actor 一种引用类型,串行化地执行对其状态的访问,天然线程安全。
Global Actor 全局唯一的 Actor,可被标注到 任意函数 / 属性 / 类型,让所有访问都在同一条串行队列上执行。

一句话:把「线程同步」这件事从手动加锁升级为「编译器帮你保证」。

系统自带:@MainActor

最常见、也是 iOS 开发者天天打交道的全局 Actor。

swift 复制代码
// 1. 标注函数 → 保证主线程
@MainActor
func updateUI() {
    label.text = "Done"      // 永远在主线程执行
}

// 2. 标注属性 → 所有读写都在主线程
@MainActor
var titles: [String] = []

// 3. 标注整个类 → 类内所有成员默认主线程
@MainActor
final class ContentViewModel {
    var titles: [String] = []
}

凡是 UI 更新、KVO、NotificationCenter 的 post/observe,都建议加上 @MainActor,省去手动 DispatchQueue.main.async。

自定义 Global Actor:三步走

当你需要把 一类业务逻辑 放到同一条串行执行队列时(如图像处理、磁盘缓存、音频渲染...),自建全局 Actor 是利器。

Step 1:声明 Actor + @globalActor

swift 复制代码
@globalActor
actor ImageProcessing {
    static let shared = ImageProcessing()   // 必须实现
    private init() {}                      // ✅ 建议私有,防止乱 new
}
  • @globalActor 告诉编译器:这是一个「全局单例」Actor。
  • 必须提供 static let shared,否则会编译错误。
  • 把 init() 设为 private,避免外部 ImageProcessing() 创建新实例。

Step 2:贴标签即可用

swift 复制代码
// 1. 标注类 → 类内所有成员自动走 ImageProcessing 队列
@ImageProcessing
final class ImageCache {
    private var store: [URL: Data] = [:]

    func store(_ data: Data, for url: URL) {
        store[url] = data          // 自动线程安全
    }
}

// 2. 标注单个函数
@ImageProcessing
func applyFilter(_ image: UIImage) -> UIImage {
    // 耗时滤镜计算
    return image
}

Step 3:跨 Actor 调用

swift 复制代码
@MainActor
class EditorViewModel {
    private let cache = ImageCache()   // 也在 ImageProcessing 上

    func saveThumbnail(for url: URL) async {
        let image = UIImage(data: try! Data(contentsOf: url))!
        let filtered = await applyFilter(image)   // ✅ 跨 Actor,用 await
        await cache.store(filtered.pngData()!, for: url)
    }
}
  • 任何跨 Actor 访问都要 await,编译器会强制你遵守。
  • 不再需要手动 DispatchQueue / NSLock,彻底告别数据竞争。

常见疑问 & 最佳实践

问题 解答
可以用在 struct / enum 吗? ✅ 可以,只要挂上 @YourGlobalActor。
能继承吗? ❌ Actor 是引用类型,不能继承;但你可以把 Actor 包装在类里。
相关推荐
布莱克60519 小时前
Swift 枚举详解:从基础语法到关联值与模式匹配
开发语言·ios·swift·枚举
布莱克60520 小时前
Swift 闭包详解:从语法到实战的完整指南
服务器·开发语言·ios·ssh·swift·闭包
wuxianda10302 天前
苹果 App 上架 4.3(a) 问题解决方案(适用 uniapp、Objective-C、Swift、Flutter 等项目)
uni-app·objective-c·swift
wuxianda10302 天前
Swift 项目用 Xcode 脚手架起步:默认工程结构和依赖组合为什么会被识别成同源
开发语言·xcode·swift·4.3a·appstore审核
布莱克6054 天前
Swift 循环与控制转移详解:从 for-in 到标签跳转
开发语言·ssh·swift·循环
东坡肘子4 天前
把「更好」放在「更快」之前 -- 肘子的 Swift 周报 #162
人工智能·swiftui·swift
布莱克6055 天前
Swift 字符串详解:从基础用法到性能与最佳实践
服务器·开发语言·ssh·字符串·swift
布莱克6056 天前
Swift 条件语句详解:从 if 到 switch 的完整指南
开发语言·ssh·swift·switch·条件语句·guard·if
布莱克6058 天前
Swift 常量详解:从 let 到编译期优化
服务器·开发语言·ssh·swift·常量·let
布莱克6058 天前
Swift 可选类型(Optionals)详解:从原理到实战
开发语言·安全·ssh·swift·optional·可选类型