KeyPathComparator

KeyPathComparator 是 Swift 中用于通过键路径（KeyPath）定义排序规则的现代工具，自 iOS 15 和 macOS 12 起引入 Foundation 框架。它通过类型安全的方式简化了基于属性的排序逻辑，特别适用于 SwiftUI 和原生集合类型的数据处理。

核心概念 #

键路径驱动：直接通过属性路径（如 \.age）指定排序依据，无需手动编写闭包。
自动比较器生成：根据属性类型自动选择 ComparableComparator（数值类型）或 String.StandardComparator.localizedStandard（字符串类型）。
多条件排序：支持组合多个 KeyPathComparator 实现优先级排序。

基础用法 #

示例 1：单属性排序 #

struct Person {
    let name: String
    let age: Int
}

let people = [
    Person(name: "张三", age: 25),
    Person(name: "李四", age: 30),
    Person(name: "王五", age: 20)
]

// 按 age 升序排序
let sortedByAge = people.sorted(using: KeyPathComparator(\.age))
// 结果：王五(20), 张三(25), 李四(30)

示例 2：降序与本地化字符串排序 #

// 按 name 降序（本地化规则）
let sortedByName = people.sorted(using: KeyPathComparator(\.name, order: .reverse))
// 若 name 为中文，自动应用本地化排序规则

进阶用法 #

多条件排序 #

struct Player {
    let competitorNumber: Int
    let round1: Int
    let round2: Int
}

let players = [
    Player(competitorNumber: 1, round1: 75, round2: 69),
    Player(competitorNumber: 2, round1: 31, round2: 93),
    Player(competitorNumber: 3, round1: 91, round2: 88)
]

// 先按 round1 降序，再按 round2 升序
let comparators = [
    KeyPathComparator(\.round1, order: .reverse),
    KeyPathComparator(\.round2)
]
let sortedPlayers = players.sorted(using: comparators)
// 结果：Player(round1:91, round2:88), Player(round1:75, round2:69), Player(round1:31, round2:93)

自定义排序逻辑 #

// 按年龄是否为偶数排序（自定义规则）
let customComparator = KeyPathComparator(\.age) { a, b in
    (a.isMultiple(of: 2), a) < (b.isMultiple(of: 2), b)
}
let customSorted = people.sorted(using: customComparator)
// 结果：偶数年龄优先，同奇偶性按数值升序

与 SwiftUI 集成 #

在 SwiftUI 中，@Query 和列表视图可直接使用 KeyPathComparator 实现动态排序：

struct LeaderboardView: View {
    @State private var sortOrder = [KeyPathComparator(\Player.round1, order: .reverse)]
    
    var body: some View {
        Table(players, sortOrder: $sortOrder) {
            TableColumn("选手编号", value: \.competitorNumber)
            TableColumn("第一轮", value: \.round1)
            TableColumn("第二轮", value: \.round2)
        }
        .onChange(of: sortOrder) { newOrder in
            players.sort(using: newOrder)
        }
    }
}

与传统方法的对比 #

特性	`KeyPathComparator`	`NSSortDescriptor`	闭包排序
类型安全	✅ 编译时检查键路径有效性	❌ 依赖字符串键路径	✅ 类型安全但冗长
语法简洁性	✅ 直接通过 `\.property` 指定	❌ 需手动拼接字符串	❌ 需完整闭包实现
多条件支持	✅ 组合多个比较器	✅ 但需手动管理数组顺序	✅ 但闭包逻辑复杂
本地化支持	✅ 自动处理字符串本地化	✅ 需显式指定选择器	❌ 需手动实现

最佳实践 #

优先使用键路径：替代闭包减少冗余代码。
利用自动比较器：对 Comparable 类型无需额外配置。
动态排序：在 SwiftUI 中结合 @State 或 @Binding 实现交互式排序。

通过 KeyPathComparator，开发者能以声明式语法高效实现复杂排序逻辑，同时享受类型安全和 Swift 原生框架的深度集成优势。