SwiftUI工具栏按钮不显示/失效问题求助（iOS17.5/Xcode15.4）

问题1：NavigationSplitView侧边栏的ToolbarItem偶尔消失 #

复杂应用中，NavigationSplitView主列表区域的.topBarTrailing位置ToolbarItem（含添加菜单）会偶尔消失，仅能通过重启应用恢复，但单视图测试代码正常。

排查与解决： #

1. 明确Toolbar作用域
   确保Toolbar直接绑定到NavigationSplitView侧边栏的导航层级根视图上，而非内部的List或VStack。显式嵌套NavigationStack，保证Toolbar的状态与导航层级同步：

   struct ContentView: View {
       @State private var showKeyboardToolbarView: Bool = false
       
       var body: some View {
           NavigationSplitView {
               // 显式添加NavigationStack作为侧边栏根视图
               NavigationStack {
                   VStack {
                       Text("Sidebar View")
                       List {
                           Text("One")
                           Text("Two")
                           Text("Three")
                       }
                   }
                   .toolbar {
                       ToolbarItem(placement: .topBarTrailing) {
                           Menu {
                               Button(action: {
                                   showKeyboardToolbarView = true
                               }, label: {
                                   Label("Add New Item", systemImage: "plus")
                               })
                           } label: {
                               Image(systemName: "ellipsis.circle")
                                   .font(.system(size: 20))
                           }
                       }
                   }
               }
               // 将fullScreenCover移到NavigationSplitView根层级，避免List刷新影响
               .fullScreenCover(isPresented: $showKeyboardToolbarView) {
                   KeyboardToolbarView()
               }
           } detail: {
               Text("Detail View")
           }
       }
   }
   

2. 稳定状态管理
   若复杂应用存在多视图共享状态，改用@StateObject托管弹出状态，避免视图重建时状态意外重置导致Toolbar失效。

问题2：键盘ToolbarItemGroup异常 #

• 用.fullScreenCover弹出视图时，键盘工具栏完全不显示
• 用.sheet弹出时，键盘工具栏显示但Next切换焦点按钮无响应

排查与解决： #

针对fullScreenCover键盘Toolbar不显示：

1. 确保导航层级完整性
   在KeyboardToolbarView中显式设置导航栏属性，保证NavigationStack的导航上下文初始化完成，避免Toolbar被忽略：

   struct KeyboardToolbarView: View {
       @Environment(\.dismiss) var dismiss
       
       @State private var name: String = ""
       @State private var subject: String = ""
       @State private var count: String = ""
       @State private var value: String = ""
       
       @FocusState private var focusedField: Field?
       
       enum Field: Hashable {
           case name, subject, count, value
       }
       
       var body: some View {
           NavigationStack {
               VStack {
                   Form {
                       TextField("Name", text: $name)
                           .focused($focusedField, equals: .name)
                       
                       TextField("Subject", text: $subject, axis: .vertical)
                           .focused($focusedField, equals: .subject)
                       
                       TextField("Count", text: $count)
                           .keyboardType(.numberPad)
                           .focused($focusedField, equals: .count)
                       
                       TextField("Value", text: $value)
                           .keyboardType(.decimalPad)
                           .focused($focusedField, equals: .value)
                   }
                   Spacer()
                   Button {
                       dismiss()
                   } label: {
                       Text("Dismiss")
                   }
               }
               .textFieldStyle(.roundedBorder)
               .padding()
               // 显式设置导航栏模式，确保Toolbar绑定生效
               .navigationBarTitle("Add Item", displayMode: .inline)
               .toolbar {
                   ToolbarItemGroup(placement: .keyboard) {
                       Button("Next") {
                           moveToNextField()
                       }
                       Button("Done") {
                           hideKeyboard()
                       }
                   }
               }
           }
       }
       
       private func moveToNextField() {
           switch focusedField {
           case .name:
               focusedField = .subject
           case .subject:
               focusedField = .count
           case .count:
               focusedField = .value
           default:
               hideKeyboard()
           }
       }
       
       private func hideKeyboard() {
           focusedField = nil
       }
   }
   

2. 排查全局键盘自定义
   检查复杂应用中是否存在UIKit层面的键盘自定义代码（如修改inputAccessoryView），这类代码会覆盖SwiftUI的键盘Toolbar，需移除或适配。

针对sheet弹出时Next按钮无响应：

1. 用ViewModel托管Focus状态
   将FocusState及输入状态移到@StateObject的ViewModel中，避免视图重建时状态丢失，保证moveToNextField能正确获取当前焦点：

   class KeyboardToolbarViewModel: ObservableObject {
       @Published var name: String = ""
       @Published var subject: String = ""
       @Published var count: String = ""
       @Published var value: String = ""
       
       @Published var focusedField: Field?
       
       enum Field: Hashable {
           case name, subject, count, value
       }
       
       func moveToNextField() {
           switch focusedField {
           case .name:
               focusedField = .subject
           case .subject:
               focusedField = .count
           case .count:
               focusedField = .value
           default:
               focusedField = nil
           }
       }
   }
   
   struct KeyboardToolbarView: View {
       @Environment(\.dismiss) var dismiss
       @StateObject private var vm = KeyboardToolbarViewModel()
       
       var body: some View {
           NavigationStack {
               VStack {
                   Form {
                       TextField("Name", text: $vm.name)
                           .focused($vm.focusedField, equals: .name)
                       
                       TextField("Subject", text: $vm.subject, axis: .vertical)
                           .focused($vm.focusedField, equals: .subject)
                       
                       TextField("Count", text: $vm.count)
                           .keyboardType(.numberPad)
                           .focused($vm.focusedField, equals: .count)
                       
                       TextField("Value", text: $vm.value)
                           .keyboardType(.decimalPad)
                           .focused($vm.focusedField, equals: .value)
                   }
                   Spacer()
                   Button {
                       dismiss()
                   } label: {
                       Text("Dismiss")
                   }
               }
               .textFieldStyle(.roundedBorder)
               .padding()
               .navigationBarTitle("Add Item", displayMode: .inline)
               .toolbar {
                   ToolbarItemGroup(placement: .keyboard) {
                       Button("Next") {
                           vm.moveToNextField()
                       }
                       Button("Done") {
                           vm.focusedField = nil
                       }
                   }
               }
           }
       }
   }
   

2. 确保Sheet在导航层级内弹出
   复杂应用中，需在NavigationStack包裹的视图中触发sheet弹出，保证环境变量（如FocusState所需的上下文）正常传递。

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