下面给你一份 Mac 新电脑安装 CocoaPods 报 Ruby 版本过低 的完整解决方案（最新版 macOS、M1/M2/M3 芯片均适用）。
🍎 为什么会报 Ruby 版本过低？
macOS 自带系统 Ruby（位置在 /usr/bin/ruby），版本通常是 2.6、2.7，已经停更。
而 CocoaPods 需要 Ruby ≥ 3.0（依赖新版 openssl、ffi 等库）。
因此必须安装 新版 Ruby（Homebrew 或 rbenv 都可以）。
✅ 最推荐方案（最稳最干净）
使用 Homebrew 安装 Ruby（完全替代系统 Ruby）
1️⃣ 安装 Ruby
brew install ruby
最新版本大概是 3.3.x。
2️⃣ 配置 PATH（关键，否则仍会调用系统 Ruby）
把 Homebrew Ruby 设为默认 Ruby：
zsh 用户（macOS 默认）
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L/opt/homebrew/opt/ruby/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/opt/homebrew/opt/ruby/include"' >> ~/.zshrc
source ~/.zshrc
Intel Mac
路径会是 /usr/local/opt/ruby/bin
3️⃣ 确认 Ruby 版本变成 3.x
ruby -v
如果依然显示 2.x → PATH 没配好。
4️⃣ 使用 Homebrew Ruby 安装 CocoaPods
gem install cocoapods
如网络问题，可以加国内源：
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
gem install cocoapods
⚠️ 常见错误 & 解决
❌ “Error: ruby not found” 或 ruby 版本依然是 2.x
说明 PATH 不生效
→ 重新检查 Homebrew 安装路径
查看 brew Ruby 安装位置：
brew --prefix ruby
然后把它加入 PATH：
echo 'export PATH="$(brew --prefix ruby)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
❌ “ffi 编译失败” / “openssl 依赖缺失”
执行：
brew install openssl
brew install libffi
然后：
gem install cocoapods -- --use-system-libraries
❌ “Permission denied @ dir_s_mkdir”（权限错误）
使用 sudo 会破坏 Ruby 环境，不要 sudo gem install。
如果你已经用过 sudo：
sudo gem uninstall cocoapods
sudo chown -R $(whoami) /Library/Ruby
然后重新用 brew Ruby 安装。
🚀 更高级方案（可选）
方案 B：使用 rbenv 管理多个 Ruby 版本
如果你还做其他 Ruby 开发，可以用：
brew install rbenv ruby-build
rbenv install 3.3.0
rbenv global 3.3.0
之后：
gem install cocoapods
🎉 最终完整命令（你可以复制一套跑完）
brew install ruby
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L/opt/homebrew/opt/ruby/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/opt/homebrew/opt/ruby/include"' >> ~/.zshrc
source ~/.zshrc
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
gem install cocoapods