@unknown

在 Swift 中，@unknown 是用于处理非冻结枚举（Non-Frozen Enum） 的特殊修饰符，主要用于应对未来可能新增枚举成员的场景，避免因枚举扩展导致的兼容性问题。以下是其核心使用场景和方法的详细说明：

一、使用场景#

1. 处理系统库提供的非冻结枚举
   @unknown 主要适用于来自 Objective-C 或 C 的枚举，例如 UIKit、Foundation 等系统框架中的枚举类型（如 UIUserInterfaceSizeClass）。这类枚举可能在未来版本中新增成员，属于非冻结的。
   示例场景： 当 UIUserInterfaceSizeClass 在 iOS 新版本中新增一个 .adaptive 类型时，旧代码若未处理该 case，使用 @unknown default 可触发警告而非编译错误。

2. 自定义枚举的例外情况
   Swift 中的自定义枚举默认是冻结的（Frozen），即编译器会假设其成员不会变化。若需要定义非冻结枚举（如跨平台的 C 库接口），需显式标记为 @frozen 的反面，但实际开发中极少需要。

二、使用方法#

1. 语法形式#

在 switch 语句中，通过 @unknown default 或 @unknown case _ 处理未明确列举的 case：

switch axis {
case .unspecified:
    print("未指定")
case .regular:
    print("常规模式")
case .compact:
    print("紧凑模式")
@unknown default:  // 或 @unknown case _
    fatalError("未知的 UIUserInterfaceSizeClass 类型")
}

2. 与普通 default 的区别#

示例： 当系统枚举新增一个 .adaptive 时，使用 default 的代码会静默执行默认逻辑，而 @unknown default 会发出警告，提示开发者适配新 case。

三、注意事项#

1. 仅用于非冻结枚举
   若枚举是冻结的（如 Swift 自定义枚举），使用 @unknown 会导致冗余警告。系统库的非冻结枚举会自动触发该需求。

2. 多语言项目中的处理
   若项目混编 Swift 和 Objective-C，需确保 Objective-C 中通过 NS_ENUM 声明的枚举在 Swift 侧使用 @unknown 处理。

3. 错误处理推荐
   在 @unknown default 分支中，建议抛出致命错误（fatalError）或记录日志，避免静默失败：

   @unknown default:
       assertionFailure("未处理的枚举新增类型: \(axis)")

四、适用性验证#

通过以下代码可验证枚举是否需要 @unknown：

// 系统枚举（非冻结）会触发警告
let axis: UIUserInterfaceSizeClass = .regular
switch axis {
case .regular: break
// 缺少其他 case 时，编译器提示添加 @unknown default
}

// 自定义 Swift 枚举（冻结）无需处理
enum FrozenEnum { case a, b }
switch FrozenEnum.a {
case .a: break
case .b: break
// 无需 default，因为编译器已知所有 case
}

总结#

@unknown 是 Swift 为系统非冻结枚举设计的兼容性工具，通过编译期警告强制开发者处理未来可能的枚举扩展。合理使用可提升代码的健壮性，避免因依赖外部库更新导致的运行时崩溃。