如何在SwiftData的@Model与#Predicate宏中使用自定义结构体/枚举？

Swift 5.9引入的SwiftData框架允许我们在@Model类中嵌套自定义结构体和枚举，但在使用#Predicate宏进行查询过滤时会遇到各种语法或运行时问题，以下是对应问题的解决方案：

问题1：枚举成员访问报错“无显式基类的成员访问” #

原代码：

// 谓词中不允许无显式基类的成员访问（来自宏'Predicate'）
let predicate = #Predicate<Item> { $0.nature == .foo }

解决方案：必须显式指定枚举的完整类型路径，不能使用简写的.foo：

let predicate = #Predicate<Item> { $0.nature == Item.Nature.foo }

原因：#Predicate宏的类型推断逻辑对关联枚举的简写支持不完善，必须明确枚举归属的类型。

问题2：rawValue比较报错“无法推断键路径类型” #

原代码：

// 无法从上下文推断键路径类型；请考虑显式指定根类型。
let predicate = #Predicate<Item> { $0.nature.rawValue == Item.Nature.foo.rawValue }

解决方案：优先使用枚举实例直接比较（参考问题1的方案），如果必须使用rawValue，可以提前将目标rawValue赋值给常量，再在谓词中引用：

let targetRaw = Item.Nature.foo.rawValue
let predicate = #Predicate<Item> { $0.nature.rawValue == targetRaw }

原因：直接在谓词中嵌套枚举rawValue访问会干扰宏的键路径推断，提前抽离常量可以避免这个问题。

问题3：嵌套结构体属性访问导致预览崩溃 #

原代码：

// 无编译错误，但在@Query中使用时会导致Xcode预览崩溃。
let predicate = #Predicate<Item> { $0.name.base.contains("Hello, world!") }

解决方案：改用显式键路径引用或字符串格式的谓词：

// 方式1：显式指定键路径
let predicate = #Predicate<Item> { item in
    item[keyPath: \Item.name.base].contains("Hello, world!")
}

// 方式2：从NSPredicate字符串转换
let predicate = #Predicate<Item>(from: "name.base CONTAINS %@", "Hello, world!")

原因：SwiftData对隐式嵌套结构体键路径的处理存在运行时bug，显式声明或使用字符串格式可以规避崩溃。

问题4：可选链式调用不被支持 #

原代码：

// 谓词中不支持可选链式调用。请显式使用flatMap(_:)函数替代。（来自宏'Predicate'）
let predicate = #Predicate<Item> { $0.name.suffix?.contains("Hello, world!") ?? false }

解决方案：按照提示用flatMap替代可选链式调用，处理可选值的访问：

let predicate = #Predicate<Item> { $0.name.suffix.flatMap { $0.contains("Hello, world!") } ?? false }

原因：#Predicate宏不支持Swift标准的可选链式调用语法，必须用flatMap来安全访问可选属性。

内容的提问来源于stack exchange，提问作者parapote