用途:这是一份 Swift 语言编码规范,优先级为 P0,用于在编写或审查 Swift 代码时统一可选值处理、协议与扩展、类型安全等方面的做法。
主要能力与规则: 可选值与安全:禁止强制解包,改用 guard let、if let 或空合并运算符 ??;判断空值用 value != nil,而不是 if let _ = value;避免隐式解包类型 Type!,应使用规范的 Type?。 协议与扩展:优先使用 struct 加协议,而非类继承;扩展用于实现协议一致性(如 extension MyType: Codable),不用于存储属性;协议见证需显式实现所有必需成员。 类型安全:避免使用 Any,改用泛型或关联类型;优先使用带关联值的枚举,而非多个可选值;默认使用值类型 struct,除非确实需要引用语义。
反模式:禁止使用 ! 运算符强制解包,应安全解包;禁止用 -1 等哨兵值表示失败,应使用 Optional;禁止 as! 强制类型转换,应使用条件转换 as?。
使用方式:资料未提供具体安装命令、集成步骤或工具调用方式,暂未提供。
适用场景:Swift 项目的代码编写、代码审查与规范落地,尤其是涉及可选值、协议设计和类型安全的场景。
限制:资料仅给出规范条目与参考主题(Optionals & Protocols),未说明适用 Swift 版本、平台、配套工具或自动化检查方式,这些信息暂未提供。