KMM项目iOS端报错：Unresolved reference: cocoapods及pod安装异常

1. 清理Xcode缓存与Derived Data #

• 关闭Xcode，执行命令删除Derived Data：rm -rf ~/Library/Developer/Xcode/DerivedData
• 清理模拟器服务缓存：killall -9 com.apple.CoreSimulator.CoreSimulatorService，随后重启模拟器

2. 重置KMM项目的iOS构建关联 #

• 在Android Studio/IntelliJ中执行File → Sync Project with Gradle Files
• 进入项目iOS目录，执行pod deintegrate，再重新运行pod install
• 打开Xcode，通过File → Project Settings → Build System确认使用New Build System，执行Cmd+Shift+K清理构建后重新编译

3. 检查CocoaPods版本与环境配置 #

• 查看当前CocoaPods版本：pod --version，若版本过低，升级到兼容Xcode 15.4的版本：sudo gem install cocoapods
• 检查环境变量PATH，确保包含CocoaPods安装路径（通常是/usr/local/bin），执行echo $PATH验证

4. 修复Kotlin Multiplatform插件缓存 #

• 关闭IDE，删除IDE缓存目录：rm -rf ~/Library/Caches/JetBrains/IntelliJIdea<版本号>（Android Studio对应目录为AndroidStudio<版本号>）
• 重新打开项目，等待Gradle同步完成后再打开Xcode

5. 验证M3芯片的Rosetta兼容性 #

• 打开终端的显示简介面板，勾选使用Rosetta打开，重新执行pod install和项目构建命令

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