Xcode报错‘interoperabilityMode不可用’：SPM C++互操作问题咨询

报错含义 #

这个错误直接说明当前环境不支持.interoperabilityMode(.Cxx)配置项——要么是你的Swift工具链版本过低，要么是项目未满足启用C互操作的前置要求。Swift的C互操作是Swift 5.9及以上版本才引入的特性，旧版本工具链根本没有这个API。

具体解决步骤 #

1. 检查并升级Swift版本 #

先在终端执行命令确认当前Swift版本：

swift --version

必须确保版本≥5.9（对应Xcode 15及以上版本）。如果版本不够，直接升级Xcode，或者从Swift官方渠道下载安装最新的独立工具链。

2. 修正SPM配置的写法 #

即使版本达标，也要确保配置放在正确位置：.interoperabilityMode必须写在具体target的swiftSettings中，而非package全局配置。完整示例如下：

let package = Package(
    name: "YourPackage",
    products: [
        .library(name: "YourPackage", targets: ["YourPackage"]),
    ],
    targets: [
        .target(
            name: "YourPackage",
            swiftSettings: [
                .interoperabilityMode(.Cxx),
                // Swift 5.9-6.0版本可能需要额外添加这个实验性开关
                .unsafeFlags(["-Xfrontend", "-enable-experimental-cxx-interop"])
            ],
            // 若依赖C++头文件，需配置头文件搜索路径
            cxxSettings: [.headerSearchPath("include")]
        ),
    ]
)

3. Xcode环境的配套设置（如果用Xcode开发） #

如果是在Xcode中打开SPM包，需要额外检查两项：

• 确认Xcode版本为15.0或更高
• 进入项目Build Settings，找到Swift Compiler - Language分类下的C++ Interoperability，设置为C++（对应代码中的.Cxx模式）
• 若仍报错，检查Other Swift Flags是否包含-enable-experimental-cxx-interop（Swift 5.9时期需要手动添加，后续版本默认启用）

4. 避坑提醒 #

• 不要把.interoperabilityMode放在package级别的swiftSettings里，必须绑定到具体target
• 如果用的是独立Swift工具链而非Xcode自带版本，要确保IDE（如VS Code）已正确切换到该工具链

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