SwiftUI中结构体布尔值已更新但视图未同步更新问题

我是SwiftUI新手，正在开发一款借助AI拆分任务的应用，采用SwiftData实现数据持久化。当前遇到的问题是：用户勾选已完成的子任务后，isCompleted属性的切换无法在视图中生效。使用toggle()函数会得到相同结果，添加mutating函数调试后，打印显示变量值确实发生了变化，但视图没有更新。

数据模型代码 #

BlendedTask（SwiftData模型类） #

@Model
class BlendedTask: Codable, Identifiable {
    var id = UUID()
    let name: String
    var subtasks: [Subtask]
    
    var task: UserTask {
        return UserTask(id: id, name: name, duration: 3, startTime: nil, priority: .medium, imageURL: "tornado", details: nil, pomodoro: true, pomodoroCounter: 0, blended: true)
    }
    
    private enum CodingKeys: String, CodingKey {
        case id, name, subtasks
    }
    
    // 初始化方法
    init(name: String, subtasks: [Subtask]) {
        self.name = name
        self.subtasks = subtasks
    }
    
    init() {
        self.id = UUID()
        self.name = ""
        self.subtasks = []
    }
    
    required init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        name = try container.decode(String.self, forKey: .name)
        subtasks = try container.decode([Subtask].self, forKey: .subtasks)
    }
}

Subtask和Detail结构体 #

// Subtask
struct Subtask: Codable, Identifiable, Hashable{
    var id = UUID()
    let name: String
    var details: [Detail]

    private enum CodingKeys: String, CodingKey {
        case id, name, details
    }
}
// Subtask详情
struct Detail: Codable, Identifiable, Hashable {
    var id = UUID()
    var description: String
    var isCompleted: Bool
    
    init(description: String) {
        self.description = description
        self.isCompleted = false
    }
    
    mutating func toggleCompleted() {
        print("-struct OLD: \(self.isCompleted)")
        self.isCompleted.toggle()
        print("-struct NEW: \(self.isCompleted)")
        print("toggled for detail: \(self.description)")
    }
}

视图实现代码 #

BlendedTaskDetailView #

struct BlendedTaskDetailView: View {
    @Environment(\.dismiss) private var dismiss

    @State private var isAnimated = false
    @Bindable var blendedTask: BlendedTask
    
    var body: some View {
        ZStack {
            Color.BG.ignoresSafeArea()
            VStack {
                Text("Task: " + blendedTask.name)
                    // 样式修饰符
                
                List {
                    ForEach(Array($blendedTask.subtasks.enumerated()), id: \.1.id) { index, $subtask  in
                        SubtaskCell(subtask: $subtask, taskNo: index + 1)
                    }
                    .listRowBackground(Color.faPurple)
                }
                // 样式修饰符
            }
            .padding(.top, 30)
        }
    }
}

SubtaskCell #

struct SubtaskCell: View {
    @Binding var subtask: Subtask
    let taskNo: Int
    
    @State private var isAnimated = false
    
    var body: some View {
        VStack(alignment: .center) {
            Text("Task \(taskNo): \(subtask.name)")
                // 样式修饰符
            
            ForEach(subtask.details.indices, id: \.self) { j in
                DetailRow(detail: $subtask.details[j])
            }
        }
        // 样式修饰符
    }
}

DetailRow #

struct DetailRow: View {
    @Binding var detail: Detail
    @State private var isAnimated = false
    
    var body: some View {
        HStack {
            VStack(alignment: .leading) {
                Text(detail.description)
            }
            Spacer()
            
            Button(action: {
                withAnimation {
                    print("-view OLD: \(detail.isCompleted)")
                    detail.toggleCompleted()
                    print("-view NEW: \(detail.isCompleted)")
                }
            }, label: {
                Image(systemName: detail.isCompleted ? "checkmark.circle.fill" : "circle")
                    .contentTransition(.symbolEffect(.replace))
            })
            .frame(width: 35, height: 35)
            .foregroundStyle(detail.isCompleted ? .green : .white)
        }
        // 样式修饰符
    }
}

UI界面 #

点击按钮时的打印输出 #

核心问题 #

1. SwiftData仅监听@Model类的属性替换，无法感知嵌套值类型（结构体）内部属性的变化。BlendedTask是@Model类，但subtasks是结构体数组，Detail也是结构体，修改isCompleted属于结构体内部属性变更，不会触发SwiftData的变更通知。
2. SubtaskCell中通过索引绑定数组元素的方式，会导致视图无法正确响应内部属性的变化。

修复步骤 #

1. 用@Observable宏让结构体属性变化可被感知（iOS 17+推荐）

给Subtask和Detail添加@Observable宏，让它们的属性变更能被SwiftUI自动检测：

import Observation

// Subtask
@Observable
struct Subtask: Codable, Identifiable, Hashable{
    var id = UUID()
    let name: String
    var details: [Detail]

    private enum CodingKeys: String, CodingKey {
        case id, name, details
    }
}
// Subtask详情
@Observable
struct Detail: Codable, Identifiable, Hashable {
    var id = UUID()
    var description: String
    var isCompleted: Bool
    
    init(description: String) {
        self.description = description
        self.isCompleted = false
    }
    
    mutating func toggleCompleted() {
        print("-struct OLD: \(self.isCompleted)")
        self.isCompleted.toggle()
        print("-struct NEW: \(self.isCompleted)")
        print("toggled for detail: \(self.description)")
    }
}

2. 优化SubtaskCell的ForEach绑定方式

直接绑定数组元素的Binding，而非通过索引：

struct SubtaskCell: View {
    @Binding var subtask: Subtask
    let taskNo: Int
    
    @State private var isAnimated = false
    
    var body: some View {
        VStack(alignment: .center) {
            Text("Task \(taskNo): \(subtask.name)")
                // 样式修饰符
            
            ForEach($subtask.details) { $detail in
                DetailRow(detail: $detail)
            }
        }
        // 样式修饰符
    }
}

3. 确保SwiftData持久化变更

在修改isCompleted后，调用modelContext.save()确保变更被持久化：

struct DetailRow: View {
    @Binding var detail: Detail
    @Environment(\.modelContext) private var modelContext
    @State private var isAnimated = false
    
    var body: some View {
        HStack {
            VStack(alignment: .leading) {
                Text(detail.description)
            }
            Spacer()
            
            Button(action: {
                withAnimation {
                    print("-view OLD: \(detail.isCompleted)")
                    detail.toggleCompleted()
                    print("-view NEW: \(detail.isCompleted)")
                    // 保存变更到SwiftData
                    try? modelContext.save()
                }
            }, label: {
                Image(systemName: detail.isCompleted ? "checkmark.circle.fill" : "circle")
                    .contentTransition(.symbolEffect(.replace))
            })
            .frame(width: 35, height: 35)
            .foregroundStyle(detail.isCompleted ? .green : .white)
        }
    }
}

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