iPad端独有Bug：切回应用时Toolbar消失

问题症状 #

• 仅iPad真机出现该Bug，模拟器运行完全正常
• 首次启动应用，详情页Toolbar显示正常
• 切换到其他应用再返回当前应用，Toolbar消失不见
• 选中列表中另一项，或者重新选中当前项，Toolbar会重新显示
• 已尝试给Toolbar内的Text添加.id(UUID())，解决了Toolbar完全不显示的问题，但切回应用后消失的问题依然存在

解决方案一：绑定选中状态+稳定视图ID #

这个方案通过明确追踪选中项的状态，给详情视图绑定稳定的ID，让SwiftUI能正确识别视图身份，解决后台返回时的Toolbar渲染问题。

修改后的完整代码：

import SwiftUI

struct ContentView: View {
    // 用状态变量追踪选中的项目，明确视图状态
    @State private var selectedItem: String? = "Item 1"
    
    var body: some View {
        NavigationSplitView {
            // 给List绑定选中状态，替代直接用NavigationLink跳转
            List(selection: $selectedItem) {
                NavigationLink("Item 1", value: "Item 1")
                NavigationLink("Item 2", value: "Item 2")
            }
        } detail: {
            if let item = selectedItem {
                detailView(text: "Detail View for \(item)")
                    .id(item) // 基于选中项的稳定ID，保证视图标识唯一且不变
            } else {
                Text("Select an Item")
            }
        }
    }
    
    @ViewBuilder
    func detailView(text: String) -> some View {
        Text(text)
            .toolbar {
                ToolbarItem(placement: .principal) {
                    Text("Item Name \(text)")
                }
            }
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
    }
}

解决方案二：监听前台通知强制刷新 #

如果不想修改原有的导航结构，可以通过监听应用进入前台的通知，手动触发视图刷新，强制Toolbar重新渲染：

import SwiftUI
import UIKit

struct ContentView: View {
    @State private var refreshMarker = UUID()
    
    var body: some View {
        NavigationSplitView {
            List {
                NavigationLink("Item 1", destination: detailView(text: "Detail View for Item 1"))
                NavigationLink("Item 2", destination: detailView(text: "Detail View for Item 2"))
            }
        } detail: {
            Text("Select an Item")
        }
        .id(refreshMarker)
        // 监听应用从后台回到前台的通知
        .onReceive(NotificationCenter.default.publisher(for: UIApplication.willEnterForegroundNotification)) { _ in
            // 更新刷新标记，强制重建视图
            refreshMarker = UUID()
        }
    }
    
    @ViewBuilder
    func detailView(text: String) -> some View {
        Text(text)
            .toolbar {
                ToolbarItem(placement: .principal) {
                    Text("Item Name \(text)")
                }
            }
    }
}

问题根源 #

iPad的NavigationSplitView在应用从后台恢复时，对Toolbar的视图缓存处理存在真机特有的逻辑问题：

• 当Toolbar内容没有明确的状态依赖时，SwiftUI不会自动触发刷新
• 之前用UUID()作为ID，虽然解决了首次加载的显示问题，但每次视图重建都会生成新ID，反而干扰了SwiftUI的状态追踪
• 绑定选中状态+稳定ID，能让SwiftUI清晰识别视图身份，后台返回时正确重建Toolbar；监听前台通知则是通过强制重建视图来确保Toolbar渲染

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