Swift

核心用法

Swift 技能为 iOS/macOS 开发者提供代码级安全指导，覆盖 Swift 语言的关键风险领域：

1. 可选值与空安全

• 强制解包 ! 的致命风险，推荐使用 guard let / if let 安全解包模式
• removeFirst() 等集合操作的前置条件检查

2. 内存管理与循环引用

• 闭包中 [weak self] 的强制使用规范
• weak 委托模式防止对象无法释放
• try! 与 try? 的生产环境禁用原则

3. 现代并发编程 (Swift Concurrency)

• async let 的即时执行特性与常见误解
• Actor 可重入性（reentrancy）导致的状态不一致风险
• @MainActor 的队列机制 vs 即时执行
• Sendable 协议的运行时崩溃防护

4. SwiftUI 状态管理

• @StateObject 与 @ObservedObject 的生命周期差异
• @EnvironmentObject 的注入失败崩溃
• View identity 变化导致 @State 重置

5. 类型系统陷阱

• 协议扩展的静态分发特性
• 值类型在集合中的修改限制
• String.Index 的字符串绑定特性

显著优点

• 权威来源：基于 Swift 官方语言规范与 Apple 平台最佳实践
• 风险前置：在编译期或编码阶段拦截常见运行时崩溃
• 现代并发：完整覆盖 Swift 5.5+ 结构化并发模型
• 框架覆盖：同步支持 UIKit 与 SwiftUI 双生态

潜在局限

• 平台绑定：仅适用于 Apple 生态（iOS、macOS、watchOS、tvOS）及 Linux 服务端 Swift
• 版本敏感：Swift 并发特性需 Swift 5.5+，旧项目迁移成本高
• 工具链依赖：需 Xcode 或 Swift 工具链支持，Windows 支持有限

适合人群

• iOS/macOS 应用开发者（初中级至高级）
• 从 Objective-C 迁移至 Swift 的遗留项目维护者
• 采用 Swift Concurrency 重构异步代码的团队成员
• 需要代码审查辅助的技术负责人

常规风险

| 风险类型 | 说明 |

|---------|------|

| 运行时崩溃 | 强制解包、数组越界、未注入 EnvironmentObject |

| 内存泄漏 | 闭包循环引用、强委托未释放 |

| 数据竞争 | Actor 状态在 await 间隙被修改 |

| 编译错误 | Sendable 不合规导致的构建失败 |

| 性能陷阱 | 泛型特化导致的二进制膨胀、debug 模式 print 残留 |

核心用法

Swift Skill 是一套纯文档型的 Swift 编程安全指南，包含 10 个专题 Markdown 文件，覆盖 Optionals 安全解包、内存管理（Retain Cycles/Weak References）、并发编程（async/await/Actors/Sendable）、Codable JSON 处理陷阱、类型系统与集合操作、SwiftUI 状态管理（@State/@StateObject/@ObservedObject）、高级特性（Property Wrappers/Macros）以及测试与构建优化等核心领域。用户可通过快速参考表定位具体文件，按需查阅特定主题的"Critical Rules"——每条规则均明确指出危险写法（如 ! 强制解包、try! 暴力错误处理）与安全替代方案（guard let、[weak self] 捕获等）。

显著优点

精准问题导向：不同于泛泛的语法教程，该 Skill 直击 Swift 开发中最易引发崩溃或隐蔽 Bug 的 30+ 个具体场景，如 Actor 重入性（reentrancy）、Sendable 运行时崩溃、SwiftUI View identity 变更导致状态丢失等高级陷阱。

权威技术对齐：内容深度契合 Swift 5.9+ 及 SwiftUI 现代并发模型，对 @MainActor 调度机制、value type 的 Sendable 自动推导等细节描述准确，适合跟进 Apple 平台最新技术演进。

零安全包袱：纯 Markdown 文档结构，无可执行代码、无外部依赖、无网络请求，用户可放心在离线环境或敏感项目中引用，不存在供应链投毒或数据外泄风险。

潜在局限

非交互式学习：仅为静态文档，无代码片段验证、无 IDE 集成提示，开发者需手动在 Xcode/Swift Playgrounds 中复现测试，学习效率依赖个人主动性。

版本覆盖有限：Swift 语言迭代快速（如 Swift 6 的严格并发检查），文档若未及时更新可能导致建议与编译器新警告冲突；当前版本 1.0.1 未声明更新机制。

平台语境偏重：示例与陷阱假设 Apple 生态（iOS/macOS/SwiftUI），服务器端 Swift（Vapor/Hummingbird）或跨平台场景（Linux/Android）的适用性需自行甄别。

适合人群

• 初中级 iOS/macOS 开发者：系统学习 Swift 安全编程范式，建立防御性编码习惯
• 代码审查者/技术负责人：快速检索特定模式的风险点，制定团队代码规范
• Swift 面试准备者：掌握高频踩坑点（如 weak self 何时必须、Actor 重入条件）
• 从 Objective-C/UKit 迁移的开发者：理解 ARC、可选类型、结构化并发的关键差异

使用风险

信息时效风险：Swift 语言特性随 Xcode 版本变化，建议结合官方 Swift Evolution 提案交叉验证；文档未声明维护频率，长期项目需评估内容新鲜度。

理解偏差风险：部分规则（如 Actor reentrancy、Sendable 动态检查）涉及运行时行为，静态阅读可能产生"已理解"假象，务必通过单元测试验证。

过度防御风险：try? 静默失败、weak self 过度使用可能掩盖真实业务错误，需在实际代码中平衡安全性与错误可见性，避免教条式应用。

来源可信度：T3 个人开发者维护，无公开仓库追溯变更历史，企业场景建议 fork 后内部维护或等待 T2/T1 来源的同类替代方案。