Flutter构建iOS项目时CocoaPods安装失败求解决方案

以下是针对Runner.workspace无法安装CocoaPods的可行解决方案，按顺序尝试：

1. 清理项目缓存并重新初始化 #

• 回到Flutter项目根目录，执行清理命令：

  flutter clean
  

• 进入iOS子目录：

  cd ios
  

• 删除旧的Pod缓存文件：

  rm -rf Podfile.lock Pods Runner.xcworkspace
  

• 重新执行pod安装：

  pod deintegrate && pod setup && pod install
  

2. 升级CocoaPods到兼容版本 #

旧版本CocoaPods可能和新Flutter/Xcode版本不兼容：

• 查看当前版本：

  pod --version
  

• 升级到最新稳定版（根据安装方式选择命令）：

  # gem安装方式
  sudo gem install cocoapods
  # Homebrew安装方式
  brew upgrade cocoapods
  

3. 修复Xcode命令行工具配置 #

Xcode命令行工具未正确配置也会导致pod安装失败：

• 打开Xcode，进入Xcode > 设置 > 位置，确认命令行工具选中了当前使用的Xcode版本。
• 或者终端执行重置命令：

  xcode-select --reset
  

4. 解决权限问题 #

如果出现权限相关报错，执行以下命令修复：

sudo chown -R $(whoami) ~/.cocoapods
sudo chown -R $(whoami) /Library/Ruby/Gems/$(ruby -e 'puts RUBY_VERSION.split(".")[0..1].join(".")')

5. 切换国内镜像源（解决网络拉取失败） #

如果是网络问题导致无法拉取pod库，切换到国内镜像：

• 替换pod默认源：

  pod repo remove trunk
  pod repo add trunk https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
  

• 或者修改iOS目录下的Podfile，将开头的source替换为国内源：

  source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
  

  之后再执行pod install

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