Xcode中Pod的Objective-C生成接口头文件无法找到Pod头文件问题

1. 检查Pod主头文件的配置 #

• 确认podspec里的public_header_files正确指向Test_Pod.h，路径不能出错：

  s.public_header_files = 'Test_Pod/Test_Pod.h'
  

• 在Xcode中选中Test_Pod.h，查看右侧面板的Target Membership，确保它被设置为Public（对应你的Pod target）。

2. 修正Swift类的导入逻辑 #

如果Swift类需要引用Objective-C代码，不要用相对路径导入头文件，改用模块导入：

import Test_Pod

Swift类标记为public后，自动生成的Test_Pod-Swift.h会依赖Pod的模块主头，直接导入文件会导致路径解析混乱。

3. 清理构建缓存并重建 #

• 终端执行pod deintegrate，接着执行pod install，彻底重置Pod的构建配置。
• 在Xcode中按Cmd+Shift+K清理构建文件夹，再重新执行构建。

4. 排查主头文件的导入问题 #

打开Test_Pod.h，确认：

• 没有循环导入的情况
• 所有需要对外暴露的Objective-C头文件，都用模块路径导入，比如#import <Test_Pod/SomeClass.h>而非相对路径

5. 验证模块映射配置（若手动修改过） #

如果之前手动编辑过Pod的module.modulemap，确保它的配置正确：

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

若从未手动修改过，CocoaPods会自动生成该文件，可跳过此步骤。

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