Swift 6迁移：全局常量与并发调用的合规处理问询

一、不可变全局常量的并发警告处理 #

Swift 6 开启 Complete 并发检查后，静态属性默认要求符合 Sendable 协议，即使是不可变值也会触发警告——这是编译器为了确保跨线程访问安全性的强制校验。

针对你的场景，解决方法如下：

1. 确认常量类型本身符合 Sendable：
   基础类型如 CGFloat、String 已默认实现 Sendable，若使用的系统类型（如旧版本的 LocalizedStringKey）未默认支持，需显式声明协议一致性：

   extension LocalizedStringKey: Sendable {}
   

2. 给静态常量所在扩展/类型标记 Sendable：
   对于扩展中的静态常量，只要扩展的类型符合 Sendable，编译器会自动推断静态常量的并发安全性：

   extension CGFloat {
       static let buttonHeight: CGFloat = 44
       static let cornerRadius: CGFloat = 8
   }
   

3. 特殊场景用 @unchecked Sendable：
   若某些不可变值因历史原因无法直接符合 Sendable，可通过 @unchecked Sendable 告知编译器已手动确认安全：

   extension SomeLegacyType: @unchecked Sendable {}
   static let legacyConstant: SomeLegacyType = ...
   

二、@MainActor 的使用与 ToastManager 调用问题 #

你给 ToastManager 标记 @MainActor 是正确的——UI 相关操作必须在主线程执行，@MainActor 能强制其所有方法、属性仅在主线程上下文访问。

在 ViewModel 的 Task 闭包中触发警告，是因为 Task 默认运行在后台线程上下文，直接调用主线程方法会引发线程冲突。正确处理方式：

1. 显式切换到主线程调用：
   使用 await MainActor.run 包裹调用逻辑，确保操作在主线程执行：

   func handleError(_ error: ErrorProtocol) {
       Task {
           // 后台任务逻辑...
           await MainActor.run {
               ToastManager.shared.present(error: error)
           }
       }
   }
   

2. 直接 await 主线程方法：
   因 present 方法被 @MainActor 修饰，直接调用时需添加 await，编译器会自动切换到主线程上下文：

   func handleError(_ error: ErrorProtocol) {
       Task {
           // 后台任务逻辑...
           await ToastManager.shared.present(error: error)
       }
   }
   

注意：await 是必须的——主线程切换属于异步操作，编译器要求显式标记以明确并发流程。

三、主线程与后台线程的安全数据传递 #

核心原则是确保传递的类型符合 Sendable，并在正确的线程上下文访问属性：

1. 让自定义类型符合 Sendable：
   比如你的 ErrorProtocol，需同时继承 Sendable，确保跨线程传递安全：

   protocol ErrorProtocol: Error, Sendable {
       var message: String { get }
   }
   
   struct UserError: ErrorProtocol {
       let message: String // 不可变值自动符合Sendable
   }
   

2. 线程切换时隔离 UI 相关操作：
   后台线程获取的结果，必须切换到主线程更新 UI 属性（如 @Published 或 @Observable 属性）：

   @Observable
   class ViewModel {
       var userData: UserData?
   
       func fetchUserData() {
           Task {
               // 后台异步获取数据
               let fetchedData = await APIService.getUserData()
               // 切换到主线程更新UI属性
               await MainActor.run {
                   self.userData = fetchedData
               }
           }
       }
   }
   

3. 按需标记 @MainActor：
   若 ViewModel 仅部分属性需要主线程访问，无需给整个类标记 @MainActor，只需给特定属性添加标记：

   @Observable
   class ViewModel {
       @MainActor var userData: UserData? // 仅此属性限制在主线程
   }
   

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