CocoaPods安装失败主因是系统Ruby过旧（如2.6.x不满足≥2.7.4要求）或环境混用，推荐用Homebrew安装独立Ruby（3.x），再换国内源（如Ruby China）、无sudo安装，并用清华镜像加速Specs仓库克隆。
macos中cocoapods安装失败，多数不是cocoapods本身的问题，而是系统自带ruby版本过旧、与gem依赖不兼容，或多个ruby环境（如homebrew ruby、rvm ruby）混用导致路径冲突。关键在于明确使用哪个ruby、避开sip限制、并确保源可用。
确认当前Ruby来源和版本
打开终端执行：
which ruby<br>ruby -v<br>echo $PATH
如果输出是 /usr/bin/ruby 且版本为2.6.x（如macOS Sonoma/Catalina默认），说明你在用系统Ruby——它已无法满足新版CocoaPods对Ruby ≥ 2.7.4的要求，直接安装会报类似 cocoapods-downloader requires Ruby version >= 2.7.4 的错误。
推荐方案：用Homebrew安装独立Ruby（最稳定）
不修改系统环境，彻底规避权限和版本问题：
- 先装Homebrew（如未安装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 将Homebrew加入PATH（Apple Silicon Mac用
/opt/homebrew，Intel用/usr/local）：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc - 安装新版Ruby：
brew install ruby - 让终端优先使用Homebrew Ruby：
echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 验证：
which ruby应返回/opt/homebrew/opt/ruby/bin/ruby，ruby -v显示3.x版本
安装CocoaPods并配置国内源
使用新Ruby后，无需sudo，也不碰系统目录：
- 更换gem源为国内镜像（如Ruby China）：
gem sources --remove https://rubygems.org/<br>gem sources -a https://gems.ruby-china.com/<br>gem sources -l
（确认只留一个有效源） - 安装CocoaPods：
gem install cocoapods - 初始化仓库（首次较慢，可后台运行）：
pod setup - 若项目中
pod install仍卡在克隆Specs，改用清华镜像：
在Podfile第一行写：source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
再执行pod repo remove master && pod repo add master https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
其他常见情况快速应对
如果已用系统Ruby且不想换环境：
- 权限错误（
Operation not permitted）：加-n /usr/local/bin指定安装路径：sudo gem install -n /usr/local/bin cocoapods - 编译失败（如ffi扩展报
checking for ffi.h no）：先装Xcode命令行工具：xcode-select --install，再重试 - 仍失败可降级安装稳定版：
gem install cocoapods -v 1.11.3（兼容性更好）
