用途:这是一份编写现代 Swift(覆盖至 Swift 6.4)的技能指南,核心理念是渐进式披露——先用最简单、最静态、单线程的方案,只在能说出理由时才引入并发、引用语义、存在类型或不安全指针。
主要能力:
- 用值类型建模:默认 struct 与 enum,仅在需要身份、共享可变状态、继承或资源生命周期时用 class;let 优先;用 enum 表达互斥状态;涉及引用类型属性时采用写时复制(isKnownUniquelyReferenced);~Copyable 表达唯一所有权。
- 错误与可选值:可恢复错误用 throw,程序错误用 precondition/fatalError;带关联值的 enum 作为错误类型;guard 处理错误路径;throws 实为 throws(any Error)、非抛为 throws(Never)。
- 并发:应用默认全部跑在主线程,按“主 actor 同步 → async/await → @concurrent → actor”逐步推进,先开启 Approachable Concurrency,应用模块设 Default Actor Isolation 为 MainActor(包中 .defaultIsolation(MainActor.self)),库不要设主 actor 默认。Swift 6.2 起 async 不再自动切线程,@concurrent 才会切到并发线程池;await 是挂起点会破坏原子性;actor 保证互斥但不保证事务,且非 FIFO。
- Sendable 与数据共享:值类型存储可 Sendable 时自动推断(仅非公开类型);公开类型需显式标注;多数模型类应保持非 Sendable;@unchecked Sendable 与 nonisolated(unsafe) 为最后手段;给出数据竞争错误排查顺序。
- 结构化并发:优先 async let 与 task group;Task {} 仅在生命周期不匹配作用域时使用;Task.detached 几乎不用;取消是协作式的;用 @TaskLocal 传递上下文;用 withCheckedContinuation 桥接回调。
- SwiftUI 并发:View 与 @State 均为 MainActor 隔离,通常无需写 @MainActor;API 签名中的 @Sendable 表示可能不在主线程,需复制值而非捕获 self;时间敏感动画放在同步回调。
- 协议与泛型:先写具体类型,发现重复再抽象协议;无自定义点的协议是浪费;优先 has-a 而非 is-a。
限制:资料为技能文档,未提供安装命令、收费或平台信息,这些暂未提供;部分内容标注 ⚠ 为未发布的 Swift 6.4 特性;并发指导基于 Swift 6.2 模型,项目若在 6.1 或更早则不适用。