使用Xcode 15.x在macOS Sonoma构建时主窗口视图不可见问题咨询

问题现象 #

使用Xcode 15.x构建的Mac应用，在macOS Sonoma系统运行时出现异常：主窗口内的原有视图完全不可见，但仍能向该视图添加新子视图，且不可见的原有视图依然可以接收并响应用户操作。

已知环境差异 #

• Xcode 14.1构建的版本，在Ventura和Sonoma上运行均正常
• Xcode 15.x构建的版本，仅在Sonoma上出现问题，Ventura上运行正常

排查与修复建议 #

1. 检查视图核心显示属性 #

Xcode 15对视图渲染的默认逻辑可能有变更，优先排查主视图或其父视图的isHidden、alpha属性是否被意外篡改。可在视图加载完成后强制重置：

override func viewDidAppear() {
    super.viewDidAppear()
    self.view.isHidden = false
    self.view.alpha = 1.0
}

2. 验证Auto Layout约束有效性 #

Sonoma对约束解析的容错逻辑有所调整，检查主视图的约束是否存在冲突，或者未正确绑定到窗口边缘。可以临时移除所有自定义约束，使用系统默认的「Pin to Edges」约束测试是否恢复显示。

3. 排查图层渲染状态 #

检查主视图的wantsLayer属性，以及对应图层的opacity、isHidden状态。Xcode 15默认启用的部分渲染优化可能导致图层未正确绘制：

self.view.wantsLayer = true
self.view.layer?.opacity = 1.0
self.view.layer?.isHidden = false

4. 适配AppKit新API兼容性 #

Xcode 15引入了AppKit的新API，若项目使用了过时的视图初始化、布局方法（比如直接修改frame而非用Auto Layout），可能在Sonoma上触发兼容性问题。建议替换废弃的NSView子类方法，统一使用现代布局方式。

5. 清理构建缓存 #

Xcode 15的缓存可能存在异常，执行以下操作后重新构建：

• 关闭Xcode，删除~/Library/Developer/Xcode/DerivedData目录下的项目缓存
• 重启Mac后重新编译项目

6. 调整部署目标设置 #

若项目部署目标低于Sonoma，Xcode 15编译时可能引入不兼容代码。尝试临时将部署目标设置为macOS 14.0（Sonoma），重新构建测试是否解决问题。

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