@Observable与@MainActor的正确使用及相关疑问解答

开发者阿泽

2026-6-21

示例代码

视图代码：

struct MyView: View {
    var viewModel = MyViewModel() // 见下方错误提示
    
    var body: some View {
        List(viewModel.cats, id:\.id) { cat in
            Text(cat.name)
        }
        .task {
            await viewModel.fetchCats()
        }
    }
}

ViewModel代码：

import Observation

@Observable
class MyViewModel {
    var cats = [Cat]()
    let apiService = APIService()
    
    func fetchCats() async {
        do {
            self.cats = try await apiService.cats()
        } catch {
            
        }
    }
}

上述代码运行正常，未出现「后台线程更新UI」类错误，但未显式切换主线程或使用@MainActor。现提出两个问题：

为何会出现这种情况？使用@Observable时是否无需@MainActor？
若仍需使用@MainActor，如何与@Observable结合使用？在MyViewModel中@Observable下方添加@MainActor后，视图中创建实例时会报错：Call to main actor-isolated initializer 'init()' in a synchronous nonisolated context（翻译：在同步的非隔离上下文调用了主 actor 隔离的初始化方法init()）

问题解答

1. 为什么没加@MainActor也不会报错？@Observable不需要@MainActor吗？

@Observable的底层实现会自动处理可观察属性的UI线程更新。当你在异步方法里修改@Observable类的属性时，框架会自动将属性变更的通知投递到主线程，确保UI能正确响应更新，所以不需要手动切换线程或加@MainActor。

但要注意：这只针对@Observable标记类的属性变更逻辑。如果ViewModel里有其他需要在主线程执行的操作（比如直接操作UIKit控件、调用UI相关API），还是需要显式用@MainActor标记对应的方法或整个类。

2. 如何结合@Observable与@MainActor？解决初始化报错的问题

当给@Observable类添加@MainActor后，整个类的初始化方法会被标记为主 actor 隔离，而SwiftUI的View结构体是非隔离的，同步创建隔离类的实例就会触发报错。有三种常见解决方式：

方式一：用`@StateObject`包装ViewModel实例

在View中改用@StateObject（适合ViewModel生命周期与View绑定的场景）来声明ViewModel，SwiftUI会自动在主 actor 上下文处理初始化：

struct MyView: View {
    @StateObject var viewModel = MyViewModel() // 替换直接声明
    
    var body: some View {
        List(viewModel.cats, id:\.id) { cat in
            Text(cat.name)
        }
        .task {
            await viewModel.fetchCats()
        }
    }
}

方式二：异步初始化ViewModel

如果需要手动控制初始化时机，可以在异步上下文里创建实例，再传递给View：

struct MyView: View {
    var viewModel: MyViewModel
    
    init() async {
        self.viewModel = await MyViewModel()
    }
    
    var body: some View {
        List(viewModel.cats, id:\.id) { cat in
            Text(cat.name)
        }
        .task {
            await viewModel.fetchCats()
        }
    }
}
// 使用时需异步创建View
let view = await MyView()

方式三：仅给特定方法标记@MainActor

不需要给整个类加@MainActor，只给需要主线程执行的方法标记，这样初始化就不会受影响：

@Observable
class MyViewModel {
    var cats = [Cat]()
    let apiService = APIService()
    
    @MainActor // 仅给需要主线程执行的方法加标记
    func fetchCats() async {
        do {
            self.cats = try await apiService.cats()
        } catch {
            
        }
    }
}

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