用途:处理 Swift 编译器并发诊断、actor 隔离、Sendable、任务结构、取消、重入、异步序列、continuation 与同步;以最小改动让隔离与所有权正确,同时保留可观察行为。不负责 SwiftUI .task 归属、应用架构与测试语法。
主要能力:版本与工具链预检(Xcode/Swift 版本、语言模式、strict-concurrency、Approachable Concurrency、默认 actor 隔离、部署目标);诊断流程:捕获确切诊断与声明、识别当前隔离/变更所有者/调用方向/跨界值、判定操作类型、施加最窄安全修复、重建并测试取消与失败行为。
隔离决策:UI 绑定可变状态用 @MainActor;内聚的后台可变状态用专用 actor;跨任务不可变值用真正的 Sendable 值类型;无状态 CPU 密集异步操作按工具链支持选择隔离;同步共享状态用有文档不变量的锁或同步原语;回调/委托 API 用一次性完成的 checked continuation 或流。默认 MainActor 隔离不意味着所有操作都适合主 actor,CPU 密集、阻塞 I/O、非 UI 服务应移出。
安全规则:优先结构化子任务而非 detached 任务,使优先级、任务本地值与取消可传播;取消是协作式的,在边界检查并清理资源;每次挂起点后重新验证 actor 状态;仅当存储图与变更模型确实满足时添加 Sendable;@unchecked Sendable 或 nonisolated(unsafe) 需有局部文档化不变量与针对性验证;不要在 await 期间持有同步锁;不要在 actor 内放锁保护其自身状态;避免在协作执行器线程上使用信号量与阻塞等待;手动任务需有明确所有者、取消点与生命周期。
互操作与流:一次性回调用 checked continuation,必须每条终止路径恰好恢复一次;多值用 AsyncStream/AsyncThrowingStream,并为委托、观察者或底层操作安装终止清理。适配委托、GCD、不安全缓冲区或同步并行循环前先阅读桥接与互操作;debounce、throttle、merge 等序列操作需参考异步算法。
常见错误与限制:用 @unchecked Sendable 或去除隔离来消除编译器错误;在 await 挂起点持有锁;用 Task.detached 代替 async let/TaskGroup;假设 await 后 actor 状态未变;用同步磁盘/网络 I/O 或 Thread.sleep 阻塞执行器线程。除迁移或构建配置请求外,不要更改项目级隔离或语言设置。资料未提供具体版本号、安装命令与价格信息。