如何在Ruby 3.1环境下安装旧版本CocoaPods 1.12.1？

1. 先清掉brew版的CocoaPods #

避免brew和gem版本冲突，先把现有brew安装的CocoaPods彻底移除：

brew uninstall cocoapods
brew cleanup cocoapods

2. 确保gem可执行路径在系统PATH中 #

你已经用brew装了Ruby 3.1，得先让系统能找到gem生成的命令。先执行以下命令查看路径：

which ruby
# 正常输出应为 /usr/local/bin/ruby（brew安装的路径）
gem env

在gem env的输出里找到EXECUTABLE DIRECTORY，大概率是/usr/local/lib/ruby/gems/3.1.0/bin或/usr/local/opt/ruby/bin。

找到路径后，把它添加到你的shell配置文件（zsh用~/.zshrc，bash用~/.bash_profile）：

# 替换成你找到的EXECUTABLE DIRECTORY路径
echo 'export PATH="/usr/local/lib/ruby/gems/3.1.0/bin:$PATH"' >> ~/.zshrc
# 让配置生效
source ~/.zshrc

3. 安装指定版本的CocoaPods #

现在直接用gem安装1.12.1版本即可，无需额外参数：

gem install cocoapods -v 1.12.1

安装完成后验证版本：

pod --version
# 应输出1.12.1

4. 解决"Gemfile not found"报错 #

如果运行pod时出现这个错误，通常是shell误将pod命令与Bundler绑定。可以这样解决：

• 直接用绝对路径执行pod：

  /usr/local/lib/ruby/gems/3.1.0/bin/pod install
  

• 临时取消Bundler关联再执行：

  unset BUNDLE_GEMFILE && pod install
  

• 永久解决：把unset BUNDLE_GEMFILE添加到你的shell配置文件中，避免全局触发Bundler。

5. 备选方案：用rbenv隔离Ruby环境（可选） #

如果上述方法仍有问题，用rbenv单独管理Ruby环境，彻底避开系统或brew Ruby的干扰：

# 安装rbenv
brew install rbenv
# 初始化到shell配置
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc
# 安装Ruby 3.1.x版本（例如3.1.4）
rbenv install 3.1.4
# 设置全局使用该Ruby版本
rbenv global 3.1.4
# 安装CocoaPods 1.12.1
gem install cocoapods -v 1.12.1
# 更新rbenv命令映射
rbenv rehash
# 验证版本
pod --version

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