Mac M1设备上Flutter项目CocoaPods安装异常问题求助

我之前在同款13英寸M1 2020款MacBook Pro上踩过完全一样的坑，折腾了好几天才搞定。结合你已经尝试过的步骤，给你一套针对性的解决方案，应该能解决这个“CocoaPods已安装但损坏”的问题：

第一步：彻底清理现有环境 #

先把所有可能冲突的CocoaPods和Ruby依赖全部卸载干净：

• 卸载Homebrew版的CocoaPods：

  brew uninstall --force cocoapods
  

• 卸载Ruby gem版的CocoaPods及其核心组件：

  sudo gem uninstall cocoapods
  sudo gem uninstall cocoapods-core
  sudo gem uninstall cocoapods-downloader
  

• 清理Flutter项目的缓存和iOS依赖文件：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock
  

第二步：用rbenv管理Ruby版本（避免版本冲突） #

M1上系统Ruby和Homebrew Ruby很容易冲突，用rbenv来统一管理是最稳妥的：

• 安装rbenv和ruby-build：

  brew install rbenv ruby-build
  

• 配置rbenv到你的Shell环境（如果用bash就把.zshrc改成.bashrc）：

  echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
  source ~/.zshrc
  

• 安装兼容M1的Ruby版本（推荐3.2.2，对ffi和CocoaPods支持最优）：

  rbenv install 3.2.2
  rbenv global 3.2.2
  

• 验证Ruby版本是否生效：

  ruby -v
  

  输出应该显示ruby 3.2.2p53（或类似版本）

第三步：通过Rosetta终端安装ffi和CocoaPods #

部分CocoaPods依赖仍需要x86架构支持，所以必须用Rosetta打开终端操作：

• 右键点击「终端」应用，选择「使用Rosetta打开」
• 安装ffi（这是解决CocoaPods架构冲突的关键）：

  gem install ffi
  

• 安装CocoaPods：

  gem install cocoapods
  

• 初始化CocoaPods仓库（如果官方源慢，可以替换成国内镜像）：

  # 官方源
  pod setup
  # 国内清华镜像（可选，速度更快）
  git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
  

第四步：配置Flutter项目的iOS Podfile #

修改项目的ios/Podfile，添加适配M1的配置：

platform :ios, '14.0'  # 确保最低iOS版本不低于14.0

installer.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES' }

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    # 统一所有依赖的最低iOS版本
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.0'
    end
  end
end

第五步：重新构建项目并验证 #

• 回到项目根目录，重新获取依赖：

  flutter pub get
  

• 进入iOS目录执行pod安装：

  cd ios && pod install
  

• 验证Flutter环境：

  flutter doctor
  

  确保输出里CocoaPods显示正常，没有红色错误
• 尝试运行项目：

  flutter run
  

补充：解决Git版本提取失败的问题 #

如果你之前碰到Git相关的RuntimeError，确保Homebrew安装的Git在PATH最前面：

• 打开~/.zshrc添加：

  export PATH="/usr/local/bin/git:$PATH"
  

• 生效配置：

  source ~/.zshrc
  

• 验证Git版本：

  git --version
  

  应该显示Homebrew安装的新版本（比如2.36.0+）

内容的提问来源于stack exchange，提问作者Sport Apps Barcelona