Swift框架调用C++遇编译错误：private module exists but no private headers

1. 检查module.modulemap配置的准确性 #

先确认你的modulemap结构是否和实际文件匹配，正确的私有模块声明应该直接关联到C++头文件，示例如下：

framework module YourSwiftFramework {
    umbrella header "YourSwiftFramework.h"
    export *
    module * { export * }

    private module CPPImpl {
        header "YourCPPHeader.h"
        requires cplusplus
    }
}

重点：这里的YourCPPHeader.h必须被标记为框架的私有头文件，在Xcode里选中该头文件，在右侧检查器的Target Membership里，勾选你的Swift框架，并设置为Private（别选Public或Project）。

2. 修正私有头文件的路径与配置 #

• 打开Xcode的框架target，进入Build Phases > Headers，把你的C++头文件拖到Private Headers列表里，确保不在Public或Project分组中。
• 前往Build Settings > Search Paths > Private Header Search Paths，添加C++头文件所在的目录（比如$(SRCROOT)/YourCPPSourceDir），让Xcode能定位到这些私有头。

3. 调整modulemap里的头文件路径 #

如果你的C++源码直接放在框架的子目录（比如Sources/CPP），modulemap又在Headers目录下，要使用相对路径指向头文件，避免路径错误：

framework module YourSwiftFramework {
    umbrella header "YourSwiftFramework.h"
    export *
    module * { export * }

    private module CPPImpl {
        header "../Sources/CPP/YourCPPHeader.h"
        requires cplusplus
    }
}

4. 清理缓存后重新编译 #

• 执行Product > Clean Build Folder（快捷键⇧⌘K）
• 关闭Xcode，删除DerivedData目录（可通过Xcode > Settings > Locations > Derived Data找到路径）
• 重新打开项目编译

额外注意事项 #

Swift只能通过C兼容接口调用C++，所以你的C头文件里，对外暴露的函数必须用extern "C"包裹，且不能涉及C专属类型（比如类、模板）：

#ifdef __cplusplus
extern "C" {
#endif

void your_cpp_function(int param);

#ifdef __cplusplus
}
#endif

同时，确保你的C++源文件（.cpp）已经添加到框架target的Compile Sources列表中，Xcode会自动编译这些文件。

内容的提问来源于stack exchange，提问作者Raphaël Maguet