如何避免NSToolbar遮挡NSViewController的视图内容？

1. 坐标系认知错误：macOS的NSView采用左下角为原点的坐标系，子视图frame的y属性代表子视图左下角相对于父视图的坐标。你要让子视图贴在父视图顶部，需要用「父视图可用区域的顶部Y值 - 子视图自身高度」作为y值，你当前仅减10的写法会导致子视图大部分区域落在父视图可视范围外。
2. 未考虑安全区缩进：默认配置下NSWindow的内容视图会延伸到半透明工具栏下方，系统会通过view.safeAreaInsets.top标注出被工具栏遮挡的不可用高度，你直接用view.bounds.maxY（整个父视图的最顶部Y值，包含被工具栏遮挡的区域）作为布局参考，自然会把内容放到被遮挡的区域。

方案1：彻底避免工具栏和内容重叠 #

直接修改NSWindow配置，让内容区域自动排列在工具栏下方，不需要手动计算偏移，适合不需要半透明工具栏效果的场景：
在ViewController的viewWillAppear方法中添加以下配置：

override func viewWillAppear() {
    super.viewWillAppear()
    // 禁止内容视图延伸到工具栏/标题栏下方
    view.window?.styleMask.remove(.fullSizeContentView)
    // 关闭工具栏半透明效果，视觉上完全和内容分离
    view.window?.titlebarAppearsTransparent = false
}

修改后调整布局的Y值计算逻辑即可正常工作：

override func viewDidLayout() {
    super.viewDidLayout()
    label.sizeToFit()
    label.frame = CGRect(
        x: 0,
        y: view.bounds.maxY - label.bounds.height,
        width: label.bounds.width,
        height: label.bounds.height
    )
}

方案2：保留半透明工具栏效果，手动避开安全区 #

如果要保留 macOS 原生的半透明工具栏视觉效果，只需要在计算布局时减去顶部安全区的高度即可：

override func viewDidLayout() {
    super.viewDidLayout()
    label.sizeToFit()
    // 减去顶部安全区高度，得到内容可用区域的最大Y值
    let safeTopY = view.bounds.maxY - view.safeAreaInsets.top
    label.frame = CGRect(
        x: view.safeAreaInsets.left,
        y: safeTopY - label.bounds.height,
        width: label.bounds.width,
        height: label.bounds.height
    )
}

如果后续改用Auto Layout进行布局，直接将子视图的顶部约束到view.safeAreaLayoutGuide.topAnchor，系统会自动避开工具栏、刘海屏等遮挡区域，不需要手动计算偏移量。

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