macOS 14下NSView停止按边界裁剪的技术问题咨询

macOS 14（Sonoma）和Xcode 15对AppKit的视图渲染逻辑做了调整，导致原本依赖父视图边界裁剪的行为不再生效，针对这个问题可以尝试以下几种解决方式：

• 显式开启视图裁剪属性
  对于需要裁剪子视图的父视图，直接通过代码设置：

  parentView.clipsToBounds = true
  

  如果使用Storyboard/XIB编辑界面，找到目标父视图，在属性检查器中勾选「Clip Subviews」选项。针对工具栏中用来控制按钮显示隐藏的容器视图，务必确保这个属性处于开启状态。

• 校验Auto Layout约束配置
  检查子视图的约束是否正确绑定到父视图的边界内，避免子视图因约束错误超出父视图范围却未被裁剪。比如确保子视图的leading、trailing、top、bottom约束都关联到父视图的对应边缘，或者通过固定宽度/高度约束限制子视图的显示范围。

• 改用工具栏原生控制方式
  对于NSToolbar中的按钮，推荐使用Apple官方提供的visibilityPriority属性来控制显示与隐藏，这比依赖裁剪更符合Sonoma的设计规范：

  toolbarItem.visibilityPriority = .defaultLow // 优先级低的项会在空间不足时自动隐藏
  

  自定义工具栏视图时，确认工具栏的autoresizingMask或Auto Layout配置正确，保证其边界能正确限制子视图的显示范围。

• 排查新布局选项影响
  查看项目构建设置中是否启用了Xcode 15新增的布局相关选项，若开启后出现异常，可尝试关闭该选项并重新构建测试。

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