RubyGems 官方源在国内访问不稳定，或者本地 gem 源配置有问题

1. 替换 RubyGems 为国内镜像源

推荐使用阿里云的 RubyGems 镜像，执行以下终端命令：

# 移除默认的官方源
gem sources --remove https://rubygems.org/

# 添加阿里云镜像源
gem sources -a https://mirrors.aliyun.com/rubygems/

# 查看当前源列表，确认只有阿里云源
gem sources -l

执行完 gem sources -l 后，输出应该只有 https://mirrors.aliyun.com/rubygems/ 这一项。

2. 重新安装 CocoaPods

源替换完成后，再次执行安装命令：

# 普通安装
gem install cocoapods

# 如果遇到权限问题，使用 sudo
sudo gem install cocoapods

3. 额外解决方法（若上述步骤无效）

更新 Ruby 版本CocoaPods 对 Ruby 版本有最低要求，版本过低会导致安装失败。可以用 rvm 或 rbenv 升级 Ruby：

# 安装 rvm（若未安装）
curl -L https://get.rvm.io | bash -s stable

# 安装最新稳定版 Ruby
rvm install ruby --latest

# 设置为默认版本
rvm use ruby --default

使用 brew 安装 CocoaPods（推荐 macOS 用户）如果 gem 安装一直失败，可以通过 Homebrew 安装：

# 先更新 brew
brew update

# 安装 CocoaPods
brew install cocoapods

直接用 brew 安装 Ruby + CocoaPods（推荐 macOS 用户）

# 1. 先更新 brew（若 brew 访问慢，可先替换 brew 国内源）
brew update

# 2. 安装 Ruby（brew 安装的 Ruby 自带国内友好的 gem 源）
brew install ruby

# 3. 将 brew 安装的 Ruby 加入系统环境（避免用系统自带旧版 Ruby）
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc  # 若用 bash，执行 source ~/.bash_profile

# 4. 验证 Ruby 版本（确保是 brew 安装的新版本，而非系统默认版）
ruby -v

# 5. 安装 CocoaPods（此时 gem 源已默认适配国内）
gem install cocoapods

最终验证

# 验证 rvm（若用方法1/2）
rvm -v

# 验证 Ruby 版本
ruby -v

# 验证 CocoaPods 安装成功
pod --version