更新Xcode项目支持Objective-C++/C++互操作遇报错，如何解决？

问题背景 #

项目包含Swift、Objective-C、Objective-C++/C代码，升级Swift到6并将「C and Objective-C Interoperability」设置改为C++/Objective-C++后，出现桥接头文件预编译头（PCH）生成失败的错误：

/Users/---/Bridging-Header.h:7:9 failed to emit precompiled header '/Users/---/Library/Developer/Xcode/DerivedData/Project-akhczzqbkaltwdgzmryrlhcpnduq/Build/Intermediates.noindex/PrecompiledHeaders/Bridging-Header-swift_3CPL2KPLMYXOU-clang_35SMM50I2WP8K.pch' for bridging header '---/Bridging-Header.h'

解决方案 #

1. 检查桥接头文件内容 #

桥接头文件.h不能直接包含纯C头文件（.hpp或未用extern "C"包裹的C声明）。当互操作性设置改为C++/Objective-C++时，桥接文件会被当作Objective-C编译，但纯C语法在Objective-C头文件中会触发编译错误。

• 移除桥接头文件中直接引入的C头文件，改用Objective-C包装层暴露C++功能。
• 示例：创建CppWrapper.h（Objective-C头）和CppWrapper.mm（Objective-C实现），在CppWrapper.h中用Objective-C接口封装C逻辑，再在桥接头文件中引入CppWrapper.h。

2. 调整核心构建设置 #

• 验证桥接文件路径：确认Objective-C Bridging Header设置的路径正确（相对于项目根目录，无拼写错误）。
• 重置预编译头：先关闭Precompile Bridging Header选项，执行Shift+Cmd+K清理构建文件夹，再重新开启该选项并编译。
• 设置文件编译类型：将所有.mm（Objective-C++）文件的Compile Sources As设置为Objective-C++，纯.m文件保持Objective-C。可在目标的Build Settings中全局设置，或单独选中文件在右侧检查器中修改。
• 清理Derived Data：直接删除~/Library/Developer/Xcode/DerivedData中对应项目的文件夹，或通过Xcode的Product > Clean Build Folder彻底清理缓存。

3. 确认版本兼容性 #

确保使用的Xcode版本支持Swift 6（需Xcode 15及以上），建议升级到最新稳定版，避免版本不匹配导致的编译异常。

4. 最小项目验证 #

创建一个极简测试项目：包含1个Swift文件、1个Objective-C文件、1个C类和对应的Objective-C包装层，开启C++/Objective-C++互操作性设置，验证是否能正常编译。对比测试项目与原项目的构建设置，定位差异点。

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