添加Swift文件后公共库PCH文件失效，编译报错求助

问题根源 #

启用use_modular_headers!或单个依赖的:modular_headers => true后，CocoaPods会将目标Pod转为模块化静态库。此时Pod的头文件会以独立模块的方式编译，不再自动继承主项目PCH的隐式导入——哪怕PCH里的#warning能打印，也只是说明PCH被加载，但模块编译的上下文隔离导致MyConstants.h的内容无法被Status.h这类公共库头文件获取。

分步解决 #

1. 缩小Modular Headers的启用范围 #

不要全局开启use_modular_headers!，只给需要的依赖（比如JSONModel）单独配置，避免影响整个项目的编译逻辑：

# 修改Podfile
target '你的主App Target' do
  # 仅给JSONModel启用模块化头
  pod 'JSONModel', :modular_headers => true
  # 公共库保持原有引用方式
  pod 'MyCommons', :path => '../common'
end

2. 显式处理公共库内部的头依赖 #

放弃依赖主项目PCH隐式导入MyConstants.h，改为在公共库的头文件中显式引用：

// 在Status.h开头添加
#import <MyCommons/MyConstants.h>

// 原有代码
@interface Status : NSObject
@property (nonatomic, assign) Role userRole; // 现在能正确识别Role枚举
@end

3. 确保公共库Podspec配置正确 #

检查公共库的podspec，将MyConstants.h标记为公开头，确保模块能正确导出该文件：

Pod::Spec.new do |s|
  s.name = 'MyCommons'
  s.version = 'x.x.x'
  s.source_files = 'Classes/**/*'
  # 指定公开头文件路径，确保MyConstants.h在其中
  s.public_header_files = 'Classes/Public/*.h'
end

4. 验证公共库自身的PCH配置（如果有） #

如果公共库本身有独立的PCH文件，确保在公共库的Target Build Settings中，Prefix Header路径正确指向自身的PCH，而非主项目的PCH。

额外说明 #

模块化编译的核心是模块隔离，这意味着每个模块的头文件必须显式声明依赖，不能依赖外部PCH的隐式导入。这种方式虽然增加了一点代码量，但能让公共库的依赖关系更清晰，也符合Swift与Objective-C混合开发的模块化规范。

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