SwiftData中@Model类PlaylistGroup的playlistItems初始化疑问

核心结论 #

必须对PlaylistGroup的playlistItems属性进行初始化，否则无法调用append方法添加元素。

问题原因 #

你的playlistItems定义为[PlaylistItem]?（可选数组），默认值是nil。尝试对nil数组调用append方法会直接触发运行时错误，自然无法添加元素。

两种可行修改方案 #

方案1：在初始化器中显式初始化空数组

@Model
class PlaylistGroup  {
    @Attribute(.unique) var groupNumberID = UUID()
    var groupName: String
    var playlistModel: PlayListModel?
    
    @Relationship(deleteRule: .cascade, inverse: \PlaylistItem.group)
    var playlistItems: [PlaylistItem]?
    
    init(groupName: String) {
        self.groupName = groupName
        self.playlistItems = [] // 初始化空数组
    }
}

方案2：将属性改为非可选空数组（更推荐）

从业务逻辑来看，一个分组可以没有条目，但数组本身不应该是nil。直接将playlistItems设为非可选并赋予默认空数组：

@Model
class PlaylistGroup  {
    @Attribute(.unique) var groupNumberID = UUID()
    var groupName: String
    var playlistModel: PlayListModel?
    
    @Relationship(deleteRule: .cascade, inverse: \PlaylistItem.group)
    var playlistItems: [PlaylistItem] = [] // 非可选空数组
    
    init(groupName: String) {
        self.groupName = groupName
        // 无需额外初始化，默认值已生效
    }
}

额外注意事项 #

• SwiftData会自动维护双向关系：只需将PlaylistItem添加到group.playlistItems，或设置item.group = group，即可完成关联，无需同时操作两者。
• @Model类默认已实现Hashable协议（基于持久化对象ID），因此PlaylistItem无需手动实现Hashable，避免自定义实现与SwiftData内置逻辑冲突。

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