SwiftUI中For-Loop内@State变量无法实时更新Text显示

问题根源 #

你遇到的核心问题是主线程被阻塞。SwiftUI的视图更新依赖主线程的空闲时间来处理，而你使用的sleep(1)会直接阻塞当前线程（无论是按钮点击的主线程，还是手动dispatch到主线程的任务），导致主线程根本没时间处理UI刷新，所有@State的更新会被积压，直到整个循环执行完毕后才一次性应用到视图上。

错误尝试的原因 #

• 尝试A：按钮点击闭包本身就在主线程执行，循环+sleep直接卡死主线程，连currentIteration = "-1"的更新都来不及处理，直到循环结束才一起刷新。
• 尝试B/C：哪怕把循环放到DispatchQueue.main.async里，本质还是在主线程执行，sleep依然阻塞主线程，UI刷新被挂起，只有循环结束后才会更新。

正确解决方案 #

要解决这个问题，需要做到两点：

1. 耗时操作（比如PDF页面转换）放到后台线程执行，避免阻塞主线程。
2. 用非阻塞的方式实现延迟（模拟场景），或在后台处理完成后回到主线程更新进度。

简化场景的修复代码

用Swift 5.5+的Task（iOS 15+/macOS 12+）是最简洁的方式，Task.sleep是挂起任务而非阻塞线程，不会占用主线程：

struct ContentView: View {
    @State var currentIteration: String = ""

    var body: some View {
        VStack {
            Text(currentIteration).padding()
            Button("Start") {
                currentIteration = String(-1)
                
                // 启动异步任务
                Task {
                    for i in 0...10 {
                        print(i)
                        // 回到主线程更新UI
                        await MainActor.run {
                            currentIteration = String(i)
                        }
                        // 非阻塞延迟1秒，替代sleep
                        try? await Task.sleep(nanoseconds: 1_000_000_000)
                    }
                }
            }
        }
    }
}

针对PDF转换的实际场景优化

你的真实需求是PDF转图片，这是典型的耗时操作，应把核心处理逻辑放到后台队列，同时定期更新进度：

struct ContentView: View {
    @State var progressText: String = ""
    let totalPages = 100

    var body: some View {
        VStack {
            Text(progressText).padding()
            Button("Convert PDF") {
                progressText = "开始处理..."
                
                Task {
                    for page in 1...totalPages {
                        // 后台处理PDF页面转换（模拟耗时操作）
                        await convertPDFPage(page)
                        
                        // 回到主线程更新进度
                        await MainActor.run {
                            progressText = "处理中：\(page)/\(totalPages)"
                        }
                    }
                    
                    await MainActor.run {
                        progressText = "处理完成！"
                    }
                }
            }
        }
    }
    
    // 模拟PDF页面转换的异步函数，实际替换为真实的PDF转UIImage逻辑
    private func convertPDFPage(_ page: Int) async {
        try? await Task.sleep(nanoseconds: 50_000_000)
    }
}

关键要点 #

• 永远不要在主线程执行耗时操作（IO、大量计算、sleep等），会导致UI卡顿甚至无响应。
• 更新@State等视图状态变量时，必须在主线程执行，MainActor.run可以确保这一点。
• Task.sleep是异步非阻塞的，不会占用线程资源，适合模拟延迟或等待异步操作。

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