VSCode中Flutter环境下CocoaPods安装失败求助

核心问题梳理 #

当前触发的连锁问题：

• 系统Ruby版本2.6.10低于drb 2.0.6要求的≥2.7.0，导致依赖无法满足
• 直接操作系统Ruby安装gem时出现权限限制
• 执行sudo gem install cocoapods无响应，根源是系统Ruby环境存在冲突

分步解决方案 #

1. 用rbenv管理Ruby版本（规避系统Ruby权限问题） #

• 先安装rbenv和ruby-build：

  brew install rbenv ruby-build
  

• 把rbenv初始化到shell配置（根据你使用的shell选择对应命令）：

  # Bash用户
  echo 'eval "$(rbenv init - bash)"' >> ~/.bash_profile
  # Zsh用户
  echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
  

• 重启终端或执行source ~/.bash_profile（对应你的shell配置文件）使配置生效
• 安装符合drb要求的Ruby版本（示例选2.7.6，兼容drb 2.0.6）：

  rbenv install 2.7.6
  

• 设置全局Ruby版本为刚安装的版本：

  rbenv global 2.7.6
  

• 验证Ruby版本是否生效：

  ruby -v
  

  输出应为ruby 2.7.6p219类的版本号

2. 安装drb依赖 #

Ruby版本升级后，直接执行以下命令（无需sudo，rbenv安装的Ruby归属当前用户）：

gem install drb -v 2.0.6

3. 安装CocoaPods #

完成上述步骤后，执行：

gem install cocoapods

安装完成后验证：

pod --version

能正常输出版本号即表示安装成功

4. 修复Flutter项目的iOS依赖 #

回到VSCode的Flutter项目，依次执行：

flutter clean
flutter pub get
cd ios
pod install

如果pod install出现缓存问题，可先执行pod repo update更新镜像源

补充排查点 #

• 若brew命令不存在，先安装Homebrew：

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

• 若rbenv安装Ruby失败，检查Xcode命令行工具是否安装：

  xcode-select --install
  

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