Mac升级最新Ruby后无法安装CocoaPods求助

一、修复Homebrew触发的版本类型错误 #

错误原因：Homebrew内部版本解析逻辑与当前Ruby环境冲突，导致TypeError #

1. 卸载损坏的Homebrew

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

2. 重新安装Homebrew

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

3. 验证Homebrew状态

   brew doctor
   

4. 用rbenv统一管理Ruby版本（规避系统Ruby冲突）
   • 安装rbenv：

     brew install rbenv
     

   • 配置rbenv到shell（zsh用户）：

     echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
     

   • 若为bash用户，替换为：

     echo 'eval "$(rbenv init - bash)"' >> ~/.bash_profile
     

   • 重启终端，安装最新稳定版Ruby（可替换为当前最新版本号）：

     rbenv install 3.2.2
     

   • 设置全局Ruby版本：

     rbenv global 3.2.2
     

   • 验证Ruby版本：

     ruby -v
     

二、解决Gem安装CocoaPods的网络错误 #

错误原因：无法解析rubygems.org域名，或网络访问受限 #

1. 切换RubyGems源到国内镜像（解决网络访问问题）
   • 删除默认源：

     gem sources --remove https://rubygems.org/
     

   • 添加国内镜像源：

     gem sources -a https://gems.ruby-china.com/
     

   • 验证源配置：

     gem sources -l
     

2. 安装CocoaPods（禁止使用sudo，避免污染系统Ruby环境）

   gem install cocoapods
   

3. 初始化Pod仓库

   pod setup
   

额外注意事项 #

• 不要混用系统Ruby、Homebrew Ruby和rbenv管理的Ruby，统一用rbenv管理可避免多数版本冲突
• 若仍有网络问题，检查系统DNS设置，或临时切换到手机热点重试

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