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