SPM替代CocoaPods引入库后遇module map文件缺失问题求助

问题场景 #

原本通过CocoaPods引入PSPDFKit、PLCrashReporter、Charts、MSAL、GzipSwift、MapboxMaps、Socket.IO，后改用SPM引入这些库：从Podfile移除目标库，删除Podfile.lock、Pods文件夹及project.xcworkspace，通过SPM添加对应库后，重新执行pod install保留其他CocoaPods依赖。切换分支后出现两类异常：

• 偶发SPM引入的库缺失提示
• 持续出现错误：

module map file '~/Library/Developer/Xcode/DerivedData/project-bjcrpfbmlnfniicgifsusnjrxcki/Build/Products/Staging-iphonesimulator/PodName/PodName.modulemap' not found

已尝试操作：清理项目构建、删除Derived Data及其他缓存、执行Reset Package Caches，项目包含多Target且已将SPM库分别添加到各Target。

解决方案 #

1. 重建CocoaPods Workspace #

分支切换后，旧Workspace可能残留无效的module路径引用，需彻底重建：

• 关闭Xcode
• 删除项目根目录下的project.xcworkspace文件夹
• 执行pod install重新生成Workspace
• 打开新生成的project.xcworkspace（而非直接打开xcodeproj）

2. 校验多Target的SPM依赖关联 #

多Target场景下，分支切换可能导致SPM库的Target关联被重置：

• 打开Xcode，进入File > Packages > Package Dependencies界面
• 逐个点击SPM库右侧的>展开详情，确认Add to Target选项中所有需要的Target均已勾选
• 完成后执行File > Packages > Resolve Package Versions确保依赖版本同步

3. 彻底清理缓存与构建产物 #

常规清理可能遗漏深层缓存，执行以下步骤：

• 关闭Xcode
• 删除~/Library/Developer/Xcode/DerivedData整个文件夹（覆盖所有项目缓存）
• 删除项目根目录下的build文件夹
• 执行pod deintegrate完全移除CocoaPods残留配置，再重新执行pod install
• 打开Workspace后，执行Product > Clean Build Folder（快捷键Cmd+Shift+K）

4. 检查Podfile配置冲突 #

确保Podfile中无残留的已迁移库引用，且多Target依赖配置清晰：

• 打开Podfile，确认PSPDFKit等7个库的所有引用已完全删除
• 若多Target共享Pod依赖，使用abstract_target统一管理，避免重复配置导致的路径冲突示例：

abstract_target 'SharedPods' do
  pod 'RemainingPod1'
  pod 'RemainingPod2'

  target 'AppTarget1' do
    inherit! :search_paths
  end

  target 'AppTarget2' do
    inherit! :search_paths
  end
end

5. 修正Target的Module搜索路径配置 #

若上述步骤无效，手动调整Build Settings：

• 选中报错的Target，进入Build Settings标签页
• 搜索Header Search Paths和Module Map Search Paths
• 删除任何指向旧Pods文件夹的无效路径引用
• 添加SPM自动生成的路径：$(BUILD_DIR)/../IntermediateBuildFilesPath/UninstalledProducts/$(PLATFORM_NAME)，设置为recursive模式

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