SwiftUI Inspector正确显示与隐藏问题排查与修复

问题1：工具栏按钮为何会隐藏？ #

原因：如果工具栏按钮放在NavigationSplitView内部视图层级中，切换Inspector时可能触发父视图重建，导致按钮所在Toolbar被重新初始化或移除；另外，若按钮显示依赖未正确绑定的状态，也会出现消失问题。
解决方法：

• 将工具栏放在WindowGroup层级的Toolbar中，而非SplitView内部，确保按钮不受SplitView状态切换影响；
• 使用@State或@AppStorage稳定管理Inspector的显示状态，避免状态丢失导致视图异常重建。

问题2：Inspector标题旁的加号是什么原因？ #

这是macOS默认Inspector面板的自带控件，用于添加新的Inspector标签页。出现该加号说明你使用了系统默认的Inspector布局逻辑，未自定义标题栏。
解决方法：

• 自定义Inspector的工具栏，替换默认标题区域：

  .toolbar {
      ToolbarItem(placement: .principal) {
          Text("自定义标题")
      }
  }
  

• 若不需要额外功能，可结合AppKit桥接隐藏加号：

  import AppKit
  
  struct InspectorView: NSViewRepresentable {
      func makeNSView(context: Context) -> NSView {
          let view = NSView()
          DispatchQueue.main.async {
              if let splitVC = view.window?.contentViewController as? NSSplitViewController {
                  splitVC.splitViewItems.last?.toolbar?.allowsUserCustomization = false
              }
          }
          return view
      }
      func updateNSView(_ nsView: NSView, context: Context) {}
  }
  

问题3：如何移除默认的“Splitview Inspector”标题？ #

直接在Inspector视图中设置自定义导航标题，或隐藏默认标题栏：

• 设置自定义标题：

  .navigationTitle("我的Inspector")
  

• 隐藏默认标题栏（若不需要标题）：

  .navigationBarHidden(true)
  

问题4：如何修复整体功能使其正常工作？ #

核心是采用正确的SplitView结构+稳定状态管理，同时避免布局冲突。以下是完整修复示例代码：

import SwiftUI

@main
struct InspectorDemoApp: App {
    @State private var isInspectorPresented = false
    @State private var editorText = "初始文本"
    
    var body: some Scene {
        WindowGroup {
            NavigationSplitView {
                List {
                    Text("侧边栏")
                }
            } detail: {
                TextEditor(text: $editorText)
                    .toolbar {
                        ToolbarItem(placement: .primaryAction) {
                            Button(action: {
                                isInspectorPresented.toggle()
                            }) {
                                Image(systemName: isInspectorPresented ? "sidebar.right" : "sidebar.right.slash")
                            }
                        }
                    }
            }
            .inspector(isPresented: $isInspectorPresented) {
                VStack {
                    Text("Inspector内容")
                    Button("修改文本") {
                        editorText = "修改后的文本"
                    }
                }
                .navigationTitle("自定义Inspector")
            }
            .navigationSplitViewStyle(.balanced)
        }
    }
}

额外注意事项：

• 确保状态变量（如isInspectorPresented）为顶级@State或@AppStorage，避免视图重建重置；
• 避免给Inspector视图设置固定宽高，可使用frame(minWidth: 200, idealWidth: 300, maxWidth: .infinity)提供合理尺寸范围，解决布局约束冲突；
• 若适配macOS 12，需替换NavigationSplitView为NSSplitView桥接或自定义SplitView。

问题5：切换时TextEditor内容未更新的原因？ #

大概率是TextEditor绑定的状态变量作用域不正确，或未被正确标记为可观察对象：

• 若状态变量是局部变量，切换Inspector时视图重建会重置变量值；
• 若@State变量放在子视图中，可能因视图重建丢失状态；
  解决方法：
• 将TextEditor绑定的状态变量提升到父视图（如App或Window层级），使用@State或@ObservedObject管理；
• 确保状态变量修改时触发视图更新（SwiftUI会自动处理@State/@ObservedObject的变化，避免错误赋值不可变值类型）。

问题6：该代码是否适配macOS 12？ #

如果你的代码使用了NavigationSplitView和.inspector()修饰符，不适配macOS 12——这两个API都是macOS 13 Ventura才引入的。
适配macOS 12的方案：
使用自定义SplitView布局，用HStack结合@State控制Inspector的宽度：

struct ContentView: View {
    @State private var inspectorWidth: CGFloat = 0
    @State private var editorText = "初始文本"
    
    var body: some View {
        HStack(spacing: 0) {
            TextEditor(text: $editorText)
                .toolbar {
                    ToolbarItem {
                        Button(action: {
                            withAnimation {
                                inspectorWidth = inspectorWidth == 0 ? 300 : 0
                            }
                        }) {
                            Image(systemName: inspectorWidth == 0 ? "sidebar.right" : "sidebar.right.slash")
                        }
                    }
                }
            
            if inspectorWidth > 0 {
                VStack {
                    Text("Inspector内容")
                    Button("修改文本") {
                        editorText = "macOS 12适配版本"
                    }
                }
                .frame(width: inspectorWidth)
                .background(Color.gray.opacity(0.1))
            }
        }
    }
}

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