SwiftUI键盘Toolbar异常求助：导航栏与工具栏显示冲突

问题根源 #

1. 多NavigationStack导致Toolbar失效：每个Tab里单独嵌套NavigationStack时，SwiftUI在Tab切换、焦点变化过程中，无法稳定将键盘Toolbar绑定到当前活跃的导航上下文。真机上视图生命周期的波动（比如切后台再返回、Tab切换时视图被卸载重建）会加剧这个问题，直接表现为Toolbar时显时隐。
2. 嵌套层级混乱丢失独立标题：把TabView塞进NavigationStack后，如果每个Tab视图仍保留自身的NavigationStack，会造成导航层级嵌套冲突，顶层NavigationStack无法感知子视图的标题设置，只能显示统一标题。

修复方案：统一导航层级 #

正确的结构是只保留一个顶层NavigationStack，将TabView作为它的子视图，每个Tab的页面直接承载内容，不再嵌套独立的NavigationStack。这样既能保证键盘Toolbar稳定显示，又能让每个Tab拥有独立的导航标题。

代码重构示例 #

1. 顶层Tabs视图（调整导航结构）

import SwiftUI

struct Tabs: View {
    var body: some View {
        NavigationStack { // 唯一的顶层导航容器
            TabView {
                SettingsTab()
                    .tabItem { Label("Settings", systemImage: "gear") }
                // 其他Tab示例
                WorkoutHistoryTab()
                    .tabItem { Label("History", systemImage: "list.bullet") }
            }
        }
    }
}

#Preview {
    Tabs()
        .modelContainer(for: [Workout.self], inMemory: true)
}

2. SettingsTab页面（移除内部NavigationStack）

import SwiftUI

struct SettingsTab: View {
    @AppStorage("isWeightInKG") private var isWeightInKG = true
    @AppStorage("incrementWeight") private var incrementWeight = 2.5

    @State private var incrementWeightState: Double?
    @FocusState private var isFocused: Bool
    
    var body: some View {
        List {
            Section("Weight settings"){
                // 重量单位选择器
                HStack(spacing: 32) {
                    Text("Weight Units")
                    Picker("", selection: $isWeightInKG) {
                        Text("KG").tag(true)
                        Text("LB").tag(false)
                    }
                    .pickerStyle(.segmented)
                }
                // 重量增量输入框
                HStack{
                    Text("Increment weight")
                    Spacer()
                    TextField(
                        String(incrementWeight * (isWeightInKG ? 1: 2.2)),
                        value: $incrementWeightState,
                        format: .number
                    )
                    .focused($isFocused)
                    .keyboardType(.decimalPad)
                    .font(.title3)
                    .fontWeight(.bold)
                    .multilineTextAlignment(.trailing)
                    .onChange(of: incrementWeightState) { newValue in
                        guard let newValue else { return }
                        let multiplier = isWeightInKG ? 1 : 2.2
                        incrementWeight = newValue / multiplier
                    }
                    .onChange(of: isWeightInKG) { _ in
                        guard incrementWeightState != nil else { return }
                        let multiplier = isWeightInKG ? 1 : 2.2
                        incrementWeightState = incrementWeight * multiplier
                    }
                    // 键盘Toolbar绑定到顶层NavigationStack，稳定显示
                    .toolbar {
                        ToolbarItem(placement: .keyboard) {
                            Button("Done", systemImage: "keyboard.chevron.compact.down"){
                                isFocused = false
                                incrementWeightState = nil
                            }
                        }
                    }
                    // 显式控制Toolbar可见性，避免状态波动导致的异常
                    .toolbar(isFocused ? .visible : .hidden, for: .keyboard)
                    Text(isWeightInKG ? "KG" : "LB")
                        .font(.caption)
                }
            }
        }
        .navigationTitle("App Settings") // 直接给当前页面设置标题，顶层导航会自动切换
    }
}

#Preview {
    NavigationStack { // 预览时需要包裹顶层导航
        SettingsTab()
    }
}

键盘激活时的警告说明 #

如果警告是和导航上下文、键盘呈现相关的（比如Attempt to present ... on ... which is already presenting），基本都是之前多NavigationStack嵌套导致的层级冲突，重构后会自动消失。如果是格式转换类的警告，只要你的逻辑没问题（比如用@FocusState正确管理焦点），大多属于SwiftUI的系统小瑕疵，不影响功能的话可以忽略，后续版本大概率会修复。

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