添加#available适配后Xcode14仍报编译错误，求解决方案

问题根源 #

Xcode14基于macOS 13 Ventura SDK，Xcode15对应macOS 14 Sonoma SDK，部分AppKit类的clipsToBounds属性在旧SDK中未被声明，即便添加#available运行时检查，Xcode14的编译器仍会因找不到属性定义抛出错误。

具体解决方法 #

方法1：SDK版本条件编译 #

通过编译器和SDK版本的条件判断，让不同Xcode版本执行适配逻辑：

#if compiler(>=5.9) && os(macOS 14.0)
    targetView.clipsToBounds = true
#else
    // Xcode14及更早版本用clipsSubviews替代（功能完全一致）
    targetView.clipsSubviews = true
#endif

方法2：运行时动态设置属性 #

利用Objective-C运行时API绕开编译期检查：

import ObjectiveC.runtime

private var clipsToBoundsKey = "clipsToBoundsKey"

// 针对NSView实例
if #available(macOS 14.0, *) {
    targetView.clipsToBounds = true
} else {
    objc_setAssociatedObject(targetView, &clipsToBoundsKey, true, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
    targetView.clipsSubviews = true
}

方法3：封装兼容扩展 #

给目标视图类添加扩展，统一对外接口：

extension NSView {
    var compatibleClipsToBounds: Bool {
        get {
            #available(macOS 14.0, *) {
                return clipsToBounds
            }
            return clipsSubviews
        }
        set {
            #available(macOS 14.0, *) {
                clipsToBounds = newValue
            }
            clipsSubviews = newValue
        }
    }
}

后续代码中直接使用targetView.compatibleClipsToBounds = true即可，无需重复写可用性判断。

额外提示 #

• 确认项目部署目标设置为支持的最低macOS版本，避免SDK版本限制引发编译问题。
• 如果是UIKit项目，clipsToBounds在Xcode14中本就存在，检查#available的平台参数是否误写为macOS而非iOS。

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