Swift 枚举详解:从基础语法到关联值与模式匹配

一、什么是 Swift 枚举

枚举(enum)用于定义一组相关的值,让代码在表达"有限状态"时更清晰、更安全。与 C 或 Objective-C 的枚举不同,Swift 的枚举是一等公民:它可以拥有方法、计算属性、构造器,甚至支持关联值和泛型,能力远超"一组整数常量"。

一个最基础的例子:

swift 复制代码
enum Direction {
    case north
    case south
    case east
    case west
}

let dir = Direction.north

当上下文已经明确类型时,可以省略枚举名,直接写 .north,这在 switch 和函数参数中非常常见。

二、枚举的基本语法

2.1 单行声明多个成员

多个 case 可以写在同一行,用逗号分隔:

swift 复制代码
enum Weekday {
    case monday, tuesday, wednesday, thursday, friday, saturday, sunday
}

2.2 使用 switch 匹配枚举

Swift 的 switch 要求穷尽所有情况,因此编译器会帮你检查是否遗漏了某个 case:

swift 复制代码
func describe(_ day: Weekday) -> String {
    switch day {
    case .monday, .tuesday, .wednesday, .thursday, .friday:
        return "工作日"
    case .saturday, .sunday:
        return "休息日"
    }
}

如果确实只想处理部分情况,可以用 default 兜底,但要注意这会失去编译器的穷尽性检查,新增 case 时容易被忽略。

2.3 遍历所有 case

让枚举遵循 CaseIterable 协议,即可通过 allCases 遍历全部成员:

swift 复制代码
enum Weekday: CaseIterable {
    case monday, tuesday, wednesday, thursday, friday, saturday, sunday
}

for day in Weekday.allCases {
    print(day)
}

三、原始值(Raw Values)

枚举可以为每个 case 指定一个同类型的默认值,称为原始值。原始值类型必须是字面量可表示的类型,如 String、Character、整数或浮点类型。

swift 复制代码
enum HTTPStatus: Int {
    case ok = 200
    case notFound = 404
    case serverError = 500
}

enum Planet: String {
    case mercury = "Mercury"
    case earth = "Earth"
}

3.1 隐式原始值

对于 Int 类型,后续 case 会自动递增;对于 String 类型,默认原始值就是 case 名本身:

swift 复制代码
enum Level: Int {
    case low      // 0
    case medium   // 1
    case high     // 2
}

enum Fruit: String {
    case apple    // "apple"
    case banana   // "banana"
}

3.2 通过原始值构造

带原始值的枚举会自动获得一个可失败构造器 init?(rawValue:):

swift 复制代码
if let status = HTTPStatus(rawValue: 404) {
    print("找到状态:\(status)")
} else {
    print("未知状态码")
}

注意返回值是可选类型,因为传入的原始值可能并不对应任何 case。

四、关联值(Associated Values)

关联值让枚举的每个 case 可以携带不同类型的附加数据,这是 Swift 枚举最强大的特性之一。它非常适合表达"带上下文的结果"或"多种形态的数据"。

swift 复制代码
enum Barcode {
    case upc(Int, Int, Int, Int)
    case qrCode(String)
}

let product = Barcode.upc(8, 85909, 51226, 3)
let code = Barcode.qrCode("https://example.com")

4.1 提取关联值

在 switch 中可以直接解构关联值:

swift 复制代码
switch product {
case .upc(let system, let manufacturer, let product, let check):
    print("UPC: \(system)-\(manufacturer)-\(product)-\(check)")
case .qrCode(let content):
    print("QR: \(content)")
}

如果某个 case 的所有关联值都用 let 绑定,可以简写为 case let .upc(a, b, c, d)。

4.2 关联值 vs 原始值

对比项 原始值 关联值
数量 每个 case 一个,类型统一 每个 case 可多个,类型可不同
定义时机 声明时固定 创建实例时传入
典型用途 映射状态码、字符串标识 携带上下文数据

五、计算属性与方法

枚举可以定义计算属性和方法,把与状态相关的逻辑内聚到类型内部:

swift 复制代码
enum Shape {
    case circle(radius: Double)
    case rectangle(width: Double, height: Double)

    var area: Double {
        switch self {
        case .circle(let radius):
            return Double.pi * radius * radius
        case .rectangle(let width, let height):
            return width * height
        }
    }

    func scaled(by factor: Double) -> Shape {
        switch self {
        case .circle(let radius):
            return .circle(radius: radius * factor)
        case .rectangle(let width, let height):
            return .rectangle(width: width * factor, height: height * factor)
        }
    }
}

注意枚举是值类型,方法内部修改自身属性时需要标记 mutating,不过上面的例子返回新值,因此不需要。

六、模式匹配与 if case

除了 switch,Swift 还提供了更轻量的匹配语法:

swift 复制代码
let shape = Shape.circle(radius: 2)

if case .circle(let radius) = shape {
    print("半径是 \(radius)")
}

guard case .rectangle(let w, let h) = shape else {
    return
}
print("宽 \(w),高 \(h)")

在 for 循环中也可以使用 case 过滤:

swift 复制代码
let shapes: [Shape] = [.circle(radius: 1), .rectangle(width: 2, height: 3)]

for case let .circle(radius) in shapes {
    print("圆的半径:\(radius)")
}

七、递归枚举

当枚举的关联值类型是枚举自身时,需要用 indirect 关键字打破无限递归,典型场景是表达式树:

swift 复制代码
indirect enum Expression {
    case number(Int)
    case addition(Expression, Expression)
    case multiplication(Expression, Expression)
}

func evaluate(_ expr: Expression) -> Int {
    switch expr {
    case .number(let value):
        return value
    case .addition(let lhs, let rhs):
        return evaluate(lhs) + evaluate(rhs)
    case .multiplication(let lhs, let rhs):
        return evaluate(lhs) * evaluate(rhs)
    }
}

let expr = Expression.addition(.number(1), .multiplication(.number(2), .number(3)))
print(evaluate(expr)) // 7

也可以只对某个 case 使用 indirect case,减少不必要的间接存储开销。

八、协议遵循与泛型

枚举可以遵循协议,例如 Codable、Equatable、Hashable。对于带关联值的枚举,Swift 能自动合成 Codable 实现:

swift 复制代码
enum Result<T>: Codable where T: Codable {
    case success(T)
    case failure(String)
}

枚举同样支持泛型,这让它可以作为通用的容器类型使用,例如自定义的 Optional 或 Result 风格类型。

九、常见实践建议

  • 用枚举替代魔法值:状态、类型、模式等有限集合优先用枚举表达,避免散落的字符串或整数常量。
  • 优先使用关联值表达上下文:当不同分支需要携带不同数据时,关联值比"可选属性堆叠"更清晰。
  • 善用穷尽性检查 :尽量不用 default,让编译器在新增 case 时提醒你补全逻辑。
  • 把逻辑内聚到枚举内部 :计算属性和方法能减少外部的 switch 重复代码。
  • 注意性能:带关联值的枚举在内存布局上可能比简单枚举更大,热点路径上需留意。

十、总结

Swift 枚举不只是常量集合,而是一种表达能力极强的建模工具。通过原始值、关联值、计算属性、模式匹配和递归定义,你可以用类型系统把业务状态描述得既精确又可读。掌握这些特性后,很多原本需要类继承或大量可选属性才能表达的场景,都能用更简洁、更安全的枚举实现。

相关推荐
茶底世界之下35 分钟前
冬日窗边的早餐:用 Awaking 留住冷光里的暖意
ios·app·产品
布莱克60544 分钟前
Swift 闭包详解:从语法到实战的完整指南
服务器·开发语言·ios·ssh·swift·闭包
小七在进步2 小时前
string的实现(3)
开发语言·c++·笔记·visual studio
专注仿真3 小时前
基于 AFSIM 的智能体训练:多智能体强化学习篇 —— QTRAN 算法实战
开发语言·python·算法·php·强化学习·afsim智能体·仿真训练
Funlang5 小时前
RISC-V 上的 Fun:第四套机器码
开发语言·risc-v·龙芯
feixing_fx13 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
Evand J13 小时前
【MATLAB例程】二维IMM-UKF定位,基于四个基站的AOA与测距辅助
开发语言·matlab
feixing_fx14 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
个 人 练 习 生14 小时前
C++:从零基础到深入了解vector的使用
开发语言·c++·经验分享·学习·程序人生·stl