如何基于Swift版本与目标SDK进行Swift代码条件编译？

一、Swift版本的条件编译 #

你之前尝试的#if swift-version >=5语法错误，Swift官方的版本条件编译语法是：

#if swift(>=5.0)
    // Swift 5.0及以上版本编译的代码
#else
    // 旧Swift版本的兼容代码
#endif

这是编译时条件，编译器会根据当前Swift版本完全跳过不符合条件的代码块，不会解析其中的内容。

二、目标SDK版本的条件编译 #

Swift没有直接的target-sdk-version编译条件，但可以通过「Swift版本+平台类型」间接判断（特定Apple SDK版本对应固定的Swift/Xcode版本），或者结合编译时条件隔离新API代码。

针对你的SwiftUI Scene修饰符示例 #

.restorationBehavior(.disabled)仅在macOS 15.0+ SDK中可用，要实现跨SDK编译兼容，必须用编译条件将调用该API的代码完全隔离，避免旧SDK编译时找不到符号：

extension Scene {
    func pleaseDisableRestoration() -> some Scene {
        // macOS 15.0+ SDK对应Swift 5.9及以上（Xcode 15.0+）
        #if os(macOS) && swift(>=5.9)
            // 若需要兼容旧系统运行，加上运行时检查
            if #available(macOS 15.0, *) {
                return self.restorationBehavior(.disabled)
            } else {
                return self
            }
        #else
            // 旧SDK编译时直接返回原Scene，使用默认行为
            return self
        #endif
    }
}

三、你之前尝试失败的原因分析 #

1. @available(swift, ...)无法解决编译时问题：
   @available是运行时可用性标记，编译时Swift 5编译器仍会解析函数体内的代码，而旧SDK中不存在restorationBehavior方法，因此直接报错。

2. 重复声明函数无效：
   即使@available标记的版本范围无重叠，Swift编译器在编译时仍会看到两个同名函数，不符合函数重载规则，因此无法通过编译。

四、补充说明 #

如果需要更精准的SDK版本判断，也可以通过Xcode的预定义宏实现，例如macOS SDK版本对应的预定义宏为MAC_OS_X_VERSION_MAX_ALLOWED，写法如下：

#if os(macOS) && MAC_OS_X_VERSION_MAX_ALLOWED >= 150000 // macOS 15.0对应数值150000
    // 新SDK专属代码
#else
    // 旧SDK兼容代码
#endif

这种方式直接基于SDK版本判断，比Swift版本关联更准确，但需记住版本对应的数值。

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