Swift中如何使用@MainActor正确初始化全局变量

正确实现方式 #

方案1：给全局变量添加@MainActor标注 #

这是最安全且完全符合Swift Actor隔离规则的方案：
直接给全局变量也标记@MainActor，编译器会自动将它的初始化上下文绑定到主Actor，直接解决编译报错：

@MainActor
struct Foo {}

@MainActor let foo = Foo()

如果需要确保应用启动前就完成初始化，只需在App启动入口的主Actor上下文主动访问一次变量，触发初始化即可：

• UIKit 应用可以在AppDelegate的启动回调中触发：

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 主动访问触发foo初始化，此时已经处于主Actor上下文
        _ = foo
        return true
    }
}

• SwiftUI 应用可以在App结构体的初始化方法中触发：

@main
struct MyApp: App {
    init() {
        _ = foo
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

方案2：非隔离上下文同步初始化（需自行保证线程安全） #

如果你确实需要在非隔离上下文同步完成初始化，且能100%保证初始化逻辑一定运行在主线程，可以使用nonisolated(unsafe)标记全局变量，告诉编译器跳过Actor隔离的静态检查，由你自己保证符合隔离规则：

nonisolated(unsafe) let foo = Foo()

使用该方案时建议加上运行时检查，避免出错：

nonisolated(unsafe) let foo: Foo = {
    dispatchPrecondition(condition: .onQueue(.main))
    return Foo()
}()

之前方案失败的原因 #

• 直接调用DispatchQueue.main.sync初始化：全局变量初始化如果运行在主线程，向主串行队列同步提交任务会触发死锁，导致崩溃。
• 自定义syncMain函数无效：Swift的Actor隔离是静态编译时检查，不会识别运行时的Thread.isMainThread判断逻辑，因此仍然会抛出编译错误。

内容的提问来源于stack exchange，提问作者Wil Gieseler