因RubyGems版本过旧导致Flutter安装CocoaPods失败

算力阿峰

2026-6-13

解决CocoaPods安装的Ruby版本不兼容问题

你的核心问题是macOS自带的Ruby版本（2.6.10）低于CocoaPods要求的3.1.0，且之前误用了Gemfile语法作为终端命令导致额外报错。按以下步骤解决：

安装Ruby版本管理工具rbenv（避免修改系统自带Ruby引发问题）
1. 用Homebrew安装rbenv：
```
brew install rbenv
```
2. 将rbenv加入shell配置（zsh用户用以下命令，bash用户替换为~/.bash_profile）：
```
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc
```
3. 查看可安装的Ruby稳定版本：
```
rbenv install --list
```
4. 安装3.1.x及以上的版本（比如3.1.4）：
```
rbenv install 3.1.4
```
5. 设置全局默认Ruby版本：
```
rbenv global 3.1.4
```
6. 验证版本是否生效：
```
ruby -v
```
  输出应显示类似ruby 3.1.4p223的内容（具体版本号可能略有差异）
安装CocoaPods
1. 先更新RubyGems：
```
gem update --system
```
2. 安装CocoaPods（无需sudo，rbenv管理的Ruby是用户级的）：
```
gem install cocoapods
```
关于之前的错误说明
你执行的gem 'algolia', '~> 3.15', '>= 3.15.4'是Ruby项目中Gemfile文件内的依赖声明语法，不是终端命令。终端安装指定版本gem的正确格式是gem install algolia -v '~> 3.15'，但这个操作和你当前的CocoaPods安装问题无关，无需执行。