SwiftUI NavigationSplitView导航栏标题切换异常问题求助

已向Apple提交Bug（编号FB12119822），确认代码逻辑无问题，针对NavigationSplitView切换视图时导航栏标题异常跳变、转场时空白后突然弹出的问题，提供以下临时可行方案：

问题现象 #

• 使用List(selection:)或navigationDestination时，切换侧边栏列表与详情视图，导航栏标题会在inline与large模式间意外跳变
• 转场过程中原标题过渡为返回按钮，但目标标题空白；转场完成后返回按钮变为默认"Back"，目标标题突然以large模式出现并挤压视图内容

临时解决方案 #

方案1：强制统一导航栏显示模式 #

给侧边栏和详情视图的所有场景明确指定导航栏标题显示模式，避免系统自动切换导致的跳变：

修改List(selection:)示例代码

import SwiftUI

fileprivate struct Item: Identifiable, Hashable {
    let id = UUID()
}

fileprivate let items = (0...10).map { _ in Item() }

struct ListWithSelectionTitleBarJumpExample: View {
    @State var selectedItem: UUID?

    var body: some View {
        NavigationSplitView {
            List(selection: $selectedItem) {
                Section {
                    ForEach(items) { item in
                        Text(item.id.uuidString)
                            .tag(item.id)
                    }
                } header: {
                    Text("Navigable rows")
                }
            }
            .navigationTitle("Navigation Title Jump")
            .navigationBarTitleDisplayMode(.large) // 强制侧边栏使用large模式
        } detail: {
            if let selectedItem,
                 let item = items.first(where: { $0.id == selectedItem }) {
                Text(item.id.uuidString)
                    .navigationTitle("Detail View")
                    .navigationBarTitleDisplayMode(.large) // 强制详情视图使用large模式
            } else {
                Text("No selection")
                    .navigationBarTitleDisplayMode(.large) // 无选中状态也统一模式
            }
        }
    }
}

struct ListWithSelectionTitleBarJumpExample_Previews: PreviewProvider {
    static var previews: some View {
        ListWithSelectionTitleBarJumpExample()
    }
}

修改List.navigationDestination示例代码

import SwiftUI

fileprivate struct Item: Identifiable, Hashable {
    let id = UUID()
}

fileprivate let items = (0...10).map { _ in Item() }

struct ListWithNavigationDestinationTitleBarJumpExample: View {
    var body: some View {
        NavigationSplitView {
            List {
                Section {
                    ForEach(items) { item in
                        NavigationLink(value: item) {
                            Text(item.id.uuidString)
                        }
                    }
                } header: {
                    Text("Navigable rows")
                }
            }
            .navigationTitle("Navigation Title Jump")
            .navigationBarTitleDisplayMode(.large) // 统一侧边栏模式
            .navigationDestination(for: Item.self) { value in
                Text(value.id.uuidString)
                    .navigationTitle("Detail View")
                    .navigationBarTitleDisplayMode(.large) // 统一目标视图模式
            }
        } detail: {
            Text("No selection")
                .navigationBarTitleDisplayMode(.large)
        }
    }
}

struct ListWithNavigationDestinationTitleBarJumpExample_Previews: PreviewProvider {
    static var previews: some View {
        ListWithNavigationDestinationTitleBarJumpExample()
    }
}

方案2：自定义导航栏标题（更稳定） #

通过toolbar自定义标题组件，绕过系统默认的标题过渡逻辑，彻底避免跳变问题：

// 以List(selection:)的详情视图为例
Text(item.id.uuidString)
    .toolbar {
        ToolbarItem(placement: .principal) {
            Text("Detail View")
                .font(.largeTitle)
                .fontWeight(.bold) // 模拟large模式标题样式
        }
    }
    .navigationBarTitleDisplayMode(.inline) // 让系统使用inline模式，我们自定义标题样式

方案说明 #

• 方案1通过强制统一显示模式，消除系统在不同视图间自动切换模式的逻辑，减少跳变触发条件
• 方案2完全自定义标题，脱离系统默认标题的过渡机制，稳定性更高，但需要手动匹配系统标题样式

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