Swift Ecosystem 是一个用于 Swift 项目开发的技能,当工作内容涉及 Swift 工程、Package.swift、swift build/test/run、swiftc、SwiftLint、SwiftFormat 或 Swift 语言本身时适用。
一、用途 该技能面向 Swift 语言与工程实践,帮助在编写、构建、测试和维护 Swift 代码时获得一致的参考约定。它覆盖语言层面的类型系统、错误处理、并发与内存管理,也覆盖工程层面的包管理、代码规范工具和编辑器集成。
二、主要能力
- 类型系统:区分结构体与枚举(值类型,复制)和类(引用类型,共享);建议无身份标识的数据模型优先使用结构体,仅在需要引用语义或继承时使用类;使用带关联值的枚举表达代数数据类型。可选值方面,推荐 if-let、guard-let、?? 和可选链,避免使用 ! 强制解包。协议方面,提倡面向协议组合而非类继承,并可通过扩展提供默认实现。泛型支持类型约束。Swift 6+ 支持 ~Copyable 非可复制类型,用于需要唯一所有权的资源(如文件句柄、锁),方法可标记 borrowing/consuming。
- 错误处理:使用 throws 处理可恢复错误,可定义遵循 Error 的枚举;也可使用 Result 类型处理异步错误或 throws 不便的场景;Swift 6+ 支持在函数签名中指定精确错误类型(typed throws)。
- 并发:使用 async/await 替代完成回调;使用 actor 保护共享可变状态;@MainActor 确保代码在主线程运行,适用于 UI 更新;Sendable 标记可安全跨并发边界传递的类型;任务组(task groups)实现结构化并发下的并行执行;Swift 6 默认启用严格并发检查,迁移时可在 Swift 5 模式下使用 -strict-concurrency=complete 逐步发现问题。
- 内存管理:在逃逸闭包中使用 [weak self] 避免循环引用;当可保证被引用对象生命周期长于闭包时使用 unowned。
- 常见模式:流式 API(Fluent API)构建复杂对象、@resultBuilder 构建 DSL、@propertyWrapper 封装属性访问。
- 反模式:避免强制解包 !、try!、as!,避免用类做简单数据容器,避免滥用 Any/AnyObject,避免闭包中的强引用循环。
- Swift 6.3 特性:首个稳定版 Android Swift SDK,支持原生 Android 开发、更新现有 Swift 包以支持 Android,以及通过 Swift Java 和 Swift Java JNI Core 在 Kotlin/Java 应用中集成 Swift 代码;@c 属性可将 Swift 函数和枚举暴露给同项目中的 C 代码;Swift Package Manager 中 Swift Build 集成作为可选项提供;嵌入式环境支持持续改进。
- Swift Package Manager:给出标准项目结构(Package.swift、Package.resolved、Sources、Tests、Plugins),Package.swift 基本结构示例(swift-tools-version: 6.3,products、dependencies、targets),依赖声明方式(精确版本 exact、版本范围 from 与区间、分支 branch、修订 revision、本地路径 path),以及 swiftSettings 配置(enableUpcomingFeature、enableExperimentalFeature、unsafeFlags)。
- 代码规范工具:提供 .swiftlint.yml 配置示例(disabled_rules、opt_in_rules、included、excluded、line_length、type_body_length、file_length)及常见规则(force_unwrapping、force_try、force_cast、empty_count、closure_spacing);提供 .swiftformat 配置示例(--swiftversion、--indent、--maxwidth、--self、--wraparguments 等)及常见选项说明。
- SourceKit-LSP:随 Swift 工具链提供,用于 IDE 集成;VS Code 中安装官方 Swift 扩展后会自动使用 SourceKit-LSP,运行 swift build 生成索引,支持代码补全、跳转定义等功能。
三、使用方式 该技能以结构化参考知识的形式组织,包含类型系统、错误处理、并发、内存管理、常见模式、反模式、Swift 6.3 特性、决策树(包类型、引用类型选择、类型选择)、Swift Package Manager 配置、SwiftLint/SwiftFormat 配置和 SourceKit-LSP 设置等章节。使用时按具体任务查阅对应章节,并遵循其中的关键规则(如新代码使用 async/await、共享可变状态使用 actor、跨并发边界标记 Sendable、逃逸闭包使用 [weak self] 等)。
四、适用场景 适用于 Swift 库或可执行文件的开发、Swift 包管理与依赖配置、Swift 代码风格与静态检查、并发与内存安全相关编码、以及 VS Code 等编辑器中的 Swift 开发。
五、限制 资料未提供该技能的安装命令、收费方式、价格、平台支持范围或效果保证等信息,这些内容暂未提供。