Flutter构建iOS应用失败：执行pod install时出错
2026-8-13
解决Flutter iOS构建时的
Error running pod install问题 针对iOS平台构建Flutter应用时出现的Error running pod install错误，可按以下步骤逐一排查解决：
清理缓存与旧配置
- 执行Flutter清理命令：
flutter clean - 进入项目的iOS目录：
cd ios - 删除旧的Pod配置文件与依赖目录：
rm -rf Podfile.lock Pods Runner.xcworkspace
- 执行Flutter清理命令：
更新CocoaPods
- 检查当前CocoaPods版本：
pod --version - 通过gem更新到最新版本：
sudo gem install cocoapods（若使用Homebrew则执行brew upgrade cocoapods） - 更新pod仓库索引：
pod repo update
- 检查当前CocoaPods版本：
处理依赖冲突
- 打开
ios/Podfile，检查是否存在插件版本限制过严的情况，尝试放宽版本范围或移除指定版本号 - 执行带仓库更新的pod安装：
pod install --repo-update
- 打开
修复权限问题
- 确保当前用户拥有iOS目录的读写权限：
sudo chown -R $(whoami) ios/ - 禁止使用
sudo pod install，避免后续出现权限混乱
- 确保当前用户拥有iOS目录的读写权限：
更新Flutter插件
- 检查过时的插件依赖：
flutter pub outdated - 更新所有插件到兼容版本：
flutter pub upgrade
- 检查过时的插件依赖：
最后回到项目根目录，执行flutter pub get，再进入iOS目录运行pod install，完成后尝试重新构建应用。
内容的提问来源于stack exchange，提问作者faccio
相关产品推荐
相关产品推荐
