SuperAPI AI 工具集

swift-best-practices

写作与研究

查看项目

更新于 10-15 22:14

技能介绍

用途:该技能用于在编写 Swift 代码时应用 Guard、值类型、不可变性与命名规范,帮助产出地道的 Swift 实现。资料将其优先级标为 P0(关键)。

主要能力与规则: 控制流方面,建议用 guard let 提前退出替代嵌套 if,在函数顶部用 guard 做前置条件检查以减少嵌套深度;switch 必须穷尽所有分支,对来自框架的冻结枚举使用 @unknown default;简单枚举匹配可用 if case .success(let value) = result。 值类型与不可变性方面,默认使用 struct 以获得值语义与线程安全,仅在需要引用标识或继承时用 class;属性和常量默认用 let,仅在需要变更时用 var;不打算被继承的类加 final 以走静态派发提升性能;优先在 struct 和 final class 中定义方法。 命名与风格方面,布尔值以 is、has、can 前缀,如 isValid、hasErrors、canEdit;遵循官方 Swift API Design Guidelines,名称用 camelCase、类型用 PascalCase;协议名用 -able、-ible、-ing 后缀,如 Codable、Identifiable;底层类型不公开时返回类型可用 some View 或 some Collection。 集合性能方面,数据转换优先用 compactMap、filter、reduce 而非显式 for-where 循环;结果只被部分消费的大序列可用 .lazy;字典访问使用默认值以避免双重可选解包。 反模式方面,避免“末日金字塔”,用 guard 提前退出;禁止对可选值强制解包 !,改用 ?? 或 if let;避免可变全局状态,改用单例(通过 static let shared 访问)或依赖注入。

使用方式与限制:资料未提供具体安装命令、调用步骤或平台要求,暂未提供。适用场景为编写或审查 Swift 代码时作为规范参考。资料未说明收费、价格或效果数据。