Swift项目新安装后模块无法加载，CocoaPods关联模块找不到求助

我太懂这种明明按步骤执行了pod install，结果编译时还是疯狂报“找不到模块”错的烦躁了！给你列几个最常见的排查和解决步骤，按顺序试下来基本都能搞定：

• 先确认你打开的是正确的项目文件
  这是新手最容易踩的坑！CocoaPods安装完成后，你必须打开项目根目录下的xxx.xcworkspace文件，而不是原来的xxx.xcodeproj。如果打开错了，Xcode根本不会识别Pods里的模块，自然会报找不到的错误。

• 彻底清理缓存并重新构建
  有时候Xcode的缓存会搞出各种奇怪的问题，按这几步来彻底重置：

  1. 完全关闭Xcode
  2. 打开终端，执行rm -rf ~/Library/Developer/Xcode/DerivedData（这会清空所有Xcode的派生数据，放心，不会影响你的项目文件）
  3. 回到项目根目录，执行pod deintegrate，把现有的Pods集成完全移除
  4. 再执行pod install重新安装所有依赖
  5. 打开生成的xxx.xcworkspace，按Cmd+Shift+K清理构建文件夹，然后再重新编译

• 检查Podfile的基础配置是否正确
  打开你的Podfile，确认顶部有这两个关键配置：

  platform :ios, '14.0' # 这个版本要和你的项目最低支持版本匹配，不能低于项目设置的版本
  use_frameworks! # Swift项目必须加这个，否则Pods不会被编译成Xcode能识别的框架（Swift 5.0+也可以用`use_modular_headers!`）
  

  如果缺少这些配置，补上后重新执行pod install。

• 验证项目Build Settings的关键路径
  打开workspace后，选中你的主项目target，进入Build Settings页面：

  1. 搜索Framework Search Paths，确认里面包含$(inherited)这个值，并且设置为递归（后面有recursive标记）
  2. 搜索Header Search Paths，同样要包含$(inherited)
     如果这些路径里没有$(inherited)，手动添加进去，保存后重新编译。

• 检查Pods目录的权限
  偶尔文件权限问题会导致Xcode无法读取Pods内容，在项目根目录执行：

  chmod -R 755 Pods/
  

  确保Pods目录有可读可执行的权限，然后重新打开workspace尝试编译。

• 终极重置方案（前面都没用的话试试这个）

  1. 关闭Xcode
  2. 删除项目目录下的Pods文件夹、Podfile.lock、xxx.xcworkspace文件
  3. 如果你的Podfile还在，直接执行pod install；如果不小心删了，先执行pod init生成新的Podfile，再把原来的依赖加进去执行pod install
  4. 打开新生成的xxx.xcworkspace再尝试编译

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