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

MacBook Air M1无法安装CocoaPods,Flutter项目创建丢失pod文件运行报错

报错说明

创建任意Flutter项目时提示CocoaPods未安装,跳过pod install步骤,iOS设备无法启动应用。
执行gem install cocoapods时提示extconf.rb执行失败,无法生成Makefile,ffi库编译错误。

问题根因

该问题是M1芯片Mac设备使用系统内置Ruby 2.6版本安装CocoaPods时的典型兼容性问题,核心原因是系统Ruby权限受限,ffi依赖库编译缺少必要的开发工具链,无法生成Makefile导致安装中断。

修复步骤
  • 第一步:安装/配置Xcode命令行工具
    执行命令安装开发工具链:
    xcode-select --install
    若提示已安装,执行命令切换到正确的工具链路径:
    安装了完整Xcode的用户执行:
    sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
    仅安装命令行工具的用户执行:
    sudo xcode-select --switch /Library/Developer/CommandLineTools

  • 第二步:安装独立Ruby版本,避免使用系统Ruby
    通过Homebrew安装高版本Ruby:
    brew install ruby
    执行以下命令将Homebrew Ruby加入全局环境变量(适配zsh默认终端):
    echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
    source ~/.zshrc
    执行ruby -v验证版本,输出大于等于2.7即为配置成功。

  • 第三步:安装CocoaPods
    先单独安装ffi依赖库:
    sudo gem install ffi -- --enable-libffi-alloc
    再执行CocoaPods安装命令:
    sudo gem install cocoapods

  • 第四步:验证安装结果
    执行pod --version,正常输出版本号即为安装成功,重新创建Flutter项目即可自动执行pod install流程。

内容的提问来源于stack exchange,提问作者Raghib Sultan

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.24 15:06:01