NSSplitViewController搭配Toolbar全高度侧边栏布局问题

你当前的配置缺失两个核心必要设置，同时NSHostingView的默认安全区行为会抵消全高布局效果，按以下步骤修复即可在保留标题、工具栏的前提下实现原生全高侧边栏：

• 1. 显式设置侧边栏 Split Item 的行为类型
     allowsFullHeightLayout属性仅在NSSplitViewItem的behavior为.sidebar时才会触发系统级的全高侧边栏逻辑，自动完成工具栏与侧边栏的融合效果。不要使用默认的.custom行为，代码参考：

  // 初始化侧边栏item时直接用sidebar构造器，或手动修改已有item的behavior
  let inspectorItem = NSSplitViewItem(sidebarWithViewController: sidebarViewController)
  inspectorItem.allowsFullHeightLayout = true
  inspectorItem.behavior = .sidebar // 必须显式设置，默认值不生效
  splitViewController.addSplitViewItem(inspectorItem)
  

• 2. 关闭 NSHostingView 的默认安全区内缩
     承载SwiftUI视图的NSHostingView默认会自动避让顶部安全区（即标题栏+工具栏区域），哪怕侧边栏视图已经延伸到窗口顶部，内部的SwiftUI内容也会主动向下偏移，造成工具栏未避让的视觉异常。通过以下代码关闭该默认行为：

  final class InspectorHostingController<Content: View>: NSHostingController<Content> {
      override func viewDidLoad() {
          super.viewDidLoad()
          // 移除所有默认安全区约束，让视图完全匹配父视图的布局范围
          (view as! NSHostingView<Content>).safeAreaRegions = []
      }
  }
  

• 3. 校准窗口标题栏配置
     保留标题与工具栏不需要修改标题可见性，仅需开启标题栏透明，配合你已经添加的fullSizeContentView样式掩码即可：

  // 保留标题显示
  window.titleVisibility = .visible
  // 开启标题栏透明实现侧边栏延伸效果
  window.titlebarAppearsTransparent = true
  window.styleMask.insert(.fullSizeContentView)
  // 保持工具栏显示
  window.toolbar?.isVisible = true
  

修复完成后会和系统原生应用（访达、Xcode）的侧边栏表现完全一致：

• 侧边栏无硬分割线隔断，顶部与工具栏自然衔接
• 滚动侧边栏内容时，内容会滑入工具栏区域呈现毛玻璃透传效果
• 窗口标题、工具栏控件全部正常显示，无布局错位

不要手动给侧边栏添加顶部布局约束避让工具栏，系统在.sidebar行为模式下会自动处理内容的默认边距，手动添加约束会导致双倍偏移问题。

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