SwiftUI（Mac Catalyst）项目中如何条件性包含macOS专属代码？

针对你遇到的showsZoomControls属性在iOS编译时报错的问题，有两个直接有效的解决方式：

1. 精准匹配Mac Catalyst环境 #

使用targetEnvironment(macCatalyst)编译条件，让代码仅在Mac Catalyst构建中编译执行，iOS构建会完全跳过这段代码，从根源避免编译器对iOS平台的检查：

#if targetEnvironment(macCatalyst)
view.showsZoomControls = true
#endif

2. 同时兼容原生macOS与Mac Catalyst #

如果你的应用同时支持原生macOS（非Catalyst）和Mac Catalyst，可以合并编译条件：

#if os(macOS) || targetEnvironment(macCatalyst)
view.showsZoomControls = true
#endif

为什么之前的方法无效？ #

• #available(macCatalyst 13.0, *)中的*会匹配所有iOS版本，编译器会判定这段代码理论上可能在iOS运行，而该属性在iOS被标记为API_UNAVAILABLE，因此触发报错。
• 用iOS 999这类无效版本号也无法绕过，因为编译器对API_UNAVAILABLE的检查是严格的，不会因版本号不存在就忽略限制。

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