You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

M1 Mac上Flutter iOS构建失败:CocoaPods已安装仍报错

解决方案:M1 Mac上Flutter iOS构建CocoaPods检测失败问题

针对你遇到的问题,以下是针对M1架构Mac的针对性修复步骤,按顺序执行:

1. 确认终端架构与CocoaPods路径

M1 Mac存在arm64和x86_64架构兼容问题,先检查当前终端使用的架构:

arch

如果输出是arm64,建议切换到Rosetta模式打开终端(右键终端app -> 显示简介 -> 勾选"使用Rosetta打开"),再执行后续命令。

然后确认CocoaPods的安装路径:

which pod

记录输出的路径(如/opt/homebrew/bin/pod或/usr/local/bin/pod)备用。

2. 彻底清理项目缓存与旧Pod配置

  • 回到Flutter项目根目录,执行:
flutter clean
rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
  • 重新获取依赖:
flutter pub get

3. 重新初始化CocoaPods并指定架构安装

进入iOS目录,根据你的安装方式执行对应命令:

方式1:使用brew重新安装(M1原生架构)

brew uninstall cocoapods
brew install cocoapods
pod setup

方式2:使用gem安装(兼容x86架构)

sudo gem uninstall cocoapods
arch -x86_64 sudo gem install cocoapods -v 1.12.1
pod setup

4. 强制指定CocoaPods路径给Flutter

如果Flutter仍然无法识别pod,可在项目ios目录下直接指定pod路径执行安装:

# 替换成你之前查到的pod路径
/opt/homebrew/bin/pod install

或者在启动Flutter前指定环境变量:

export PATH="/opt/homebrew/bin:$PATH"
flutter run ios

5. 验证Xcode命令行工具配置

确保Xcode命令行工具已正确安装并关联:

xcode-select --install
xcode-select -s /Applications/Xcode.app/Contents/Developer

打开Xcode,进入Preferences -> Locations,确认Command Line Tools选择的是Xcode14.2。

6. 检查Podfile的平台版本

打开ios目录下的Podfile,确保平台版本与Xcode兼容:

platform :ios, '14.0' # Xcode14.2最低支持iOS14.0,可根据项目需求调整

执行完以上步骤后,重新尝试Flutter iOS构建或pod install,即可解决CocoaPods检测失败的问题。

内容的提问来源于stack exchange,提问作者Harshal Chaudhari

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.15 10:12:47