主 actor（MainActor）是 Swift 并发模型（Swift Concurrency）中的一个特殊的 actor（执行者）。
用于声明某些代码（如类、方法、属性）只能在主线程（Main Thread）上运行。这在需要与用户界面交互的场景中非常常见，因为 UI 更新必须在主线程中执行。
让被它保护的代码安全地在主线程上运行。
基本作用
在 Swift 并发系统中，actor 是一种“隔离域”——每个 actor 都保证：
1、自己内部的可变状态不会被并发访问；
2、对它的访问会自动排队、顺序执行；
3、调用它的方法时，Swift 会自动“跳转”到那个 actor 所在的执行上下文。
MainActor 就是一个特殊的、全局唯一的 actor，它的任务队列绑定到主线程（在 iOS/macOS 上是 DispatchQueue.main）。
换句话说：MainActor 就是主线程的并发化封装。
任何被标记为 @MainActor 的代码，Swift 会确保一定在主线程上顺序执行。从而确保：
1、线程安全：确保被标记的代码在主线程中运行，从而避免多线程竞争问题。
2、简化代码：不需要手动切换到主线程，Swift 自动处理线程调度。
3、编译时保证：Swift 编译器会检测所有对 @MainActor 隔离内容的访问是否符合隔离规则，避免运行时错误。
使用方法
1、标记一个函数
@MainActor
func updateUI() {
label.text = "Updated!"
}这意味着任何调用 updateUI() 的地方，都会自动调度到主线程。
2、标记一个类型
@MainActor
class ViewModel {
var title: String = ""
func refresh() {
title = "Hello"
}
}代表这个类里的所有属性和方法都属于主 actor，它们在访问时会自动回到主线程。
只能在主线程或 @MainActor 隔离上下文中访问。
3、配合异步任务
Task {
let data = await fetchData() // 在后台线程运行
await MainActor.run {
label.text = data.title // 切回主线程更新 UI
}
}或者在异步任务里临时切换回主线程：
private func loadInitialDataIfNeeded() {
Task { @MainActor in
let context = modelContainer.mainContext
...
}
}MainActor.run { … } 等价于“在主线程上执行这个闭包”。
如果不在主线程中调用标记 @MainActor方法，Swift会检测出这个潜在的并发问题，触发编译器错误。具体请见文章底部的扩展知识部分。
使用场景
1、涉及UI更新或间接触发UI刷新的逻辑；
2、使用的框架（如SwiftData）本身强制要求在主线程上操作；
3、涉及全局状态的修改或访问（比如环境中的ModelContainer）。
如果是和主线程无关的代码逻辑、网络请求等数据操作，就不需要使用 @MainActor。
因为有些代码涉及更新UI，使用 @MainActor 可以保证线程安全，只在主线程中执行。在非主线成执行代码时，Swift 会抛出错误。
如果涉及 UI 的代码，无法保证代码在主线程执行，可能会导致程序潜在的系统崩溃风险。
总结
主actor（MainActor）是 Swift 并发系统的主线程代表，它保证被标记的代码安全、顺序地在主线程执行。
它减少了手动线程管理的复杂性，并提供编译时的线程安全保证。
使用时要注意异步代码的正确调用方式，以避免隔离上下文的不匹配问题。
非隔离的上下文意味着代码没有被限定在特定的线程或执行上下文中，而隔离的上下文（例如 @MainActor）则强制代码在特定的线程中运行。试图跨越这种边界访问资源会引发错误，Swift 的这种限制是为了保证线程安全性和程序的稳定性。
在以前的写法里，我们用 GCD 手动管理线程：
DispatchQueue.main.async {
label.text = "Hello"
}但这种方式编译器不知道线程信息，也无法阻止在后台线程访问 UI。
而使用 @MainActor，编译器就能静态检测出线程访问错误：
@MainActor var label: UILabel!
func updateLabel() {
label.text = "Hi" // 安全，编译器知道在主线程执行
}
Task {
await updateLabel() // 会自动切回主线程
}如果没有添加 await 或在错误的线程访问，它会直接在编译期报错。
相关文章
1、Swift主线程标记@MainActor：https://fangjunyu.com/2024/12/25/swift%e4%b8%bb%e7%ba%bf%e7%a8%8b%e6%a0%87%e8%ae%b0mainactor
2、Swift主线程：https://fangjunyu.com/2024/12/25/swift%e4%b8%bb%e7%ba%bf%e7%a8%8b/
3、Swift并发模型中的MainActor.run方法：https://fangjunyu.com/2025/05/15/swift%e5%b9%b6%e5%8f%91%e6%a8%a1%e5%9e%8b%e4%b8%ad%e7%9a%84mainactor-run%e6%96%b9%e6%b3%95/
4、Swift并发模型中的Actor：https://fangjunyu.com/2024/10/22/swift%e7%a7%91%e6%99%ae%e6%96%87%e3%80%8aactor-%e9%9a%94%e7%a6%bb%e3%80%8b/
扩展知识
1、主线程隔离属性
在Swift中，如果试图从非隔离的上下文中访问与主线程（Main Actor）隔离的属性，Swift会提示明确地将调用隔离到主线程。
Xcode报错：
Main actor-isolated property 'mainContext' can not be referenced from a non-isolated context
Add '@MainActor' to make instance method 'loadInitialDataIfNeeded()' part of global actor 'MainActor'这个报错的的原因在于，代码想要访问 SwiftData的上下文Context，这个上下文Context被标记为 @MainActor。
报错代码不一定在主线程中调用，因此编译器就会提示报错，表示被标记 @MainActor 的上下文 Context必须被隔离到主线程。
因此，就需要将报错代码也标记为 @MainActor，这样就可以在主线程中调用该方法，并访问SwiftData的上下文Context。
通常做法是：
@MainActor // 确保方法在主线程上运行
private func loadInitialDataIfNeeded() {
let context = modelContainer.mainContext
...
}或者在异步任务里临时切换回主线程：
private func loadInitialDataIfNeeded() {
Task { @MainActor in
let context = modelContainer.mainContext
...
}
}这样就可以确保该方法始终在主线程上运行。
