iOS Swift项目导入C++库头文件失败，求有效解决方案

问题背景 #

正在学习iOS平台Swift与C交互开发，已成功编译运行ios-cmake仓库中的Objective-C示例项目。但新建Swift项目导入预编译C库时，Swift代码中尝试import HelloWorldIOS.h提示“No such module found”。已按官方文档创建example-Bridging-Header.h桥接文件、配置Target Build Settings中的Header Search Paths，且Objective-C Bridging Header路径设置为example-swift/example-Bridging-Header.h，问题仍未解决。

排查与解决步骤 #

• 纠正桥接文件的使用逻辑：Swift代码中不需要写import HelloWorldIOS.h，正确操作是在桥接文件example-Bridging-Header.h中添加#import "HelloWorldIOS.h"，桥接文件会自动将C++/OC的接口暴露给Swift。
• 验证头文件搜索路径配置：在Target的Build Settings -> Header Search Paths中，添加预编译C++库头文件所在的目录，建议设置为递归（Recursive），确保编译器能找到所有嵌套目录下的头文件。路径可使用相对路径（如$(SRCROOT)/ThirdParty/Headers）或绝对路径，避免拼写错误。
• 链接C++标准库：在Target的Build Phases -> Link Binary With Libraries中添加libc++.tbd，或在Build Settings -> Linking -> Other Linker Flags中添加-lc++。Swift调用C库必须依赖C标准库，这是容易遗漏的关键配置。
• 检查预编译库的架构兼容性：使用lipo -info <库文件路径>命令查看预编译库支持的架构，确保包含当前编译目标的架构（如arm64、x86_64），若架构不匹配需重新编译多架构版本的库。

最终解决结果 #

通过添加链接libc++.tbd成功解决了头文件无法识别的问题。

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