终端安装CocoaPods报错求助：Ruby版本不兼容（M1 Air）
2026-7-6
问题解答
这个报错和M1 Air有间接关联，但核心原因是Ruby版本不达标。
M1芯片的MacOS默认预装的Ruby版本为2.6.x系列，而你尝试安装的新版CocoaPods依赖的cocoapods-downloader 2.0+版本要求Ruby版本≥2.7.4，当前系统自带的Ruby版本（2.6.10.210）无法满足该依赖要求，因此触发了安装报错。
解决方法
路径1：升级Ruby版本（推荐）
通过Ruby版本管理工具（如rbenv）升级到符合要求的Ruby版本：
- 安装rbenv：
brew install rbenv - 初始化rbenv：执行
rbenv init后，重启终端或运行source ~/.zshrc（若使用Zsh终端） - 查看可安装的Ruby版本：
rbenv install -l - 安装2.7.4或更高版本：
rbenv install 2.7.4 - 设置全局Ruby版本：
rbenv global 2.7.4 - 验证版本：
ruby -v，确认显示为2.7.4及以上 - 重新安装CocoaPods：
gem install cocoapods
路径2：安装兼容旧Ruby的CocoaPods版本
若不想升级Ruby，可安装支持Ruby 2.6.x的CocoaPods旧版本：
- 执行命令：
gem install cocoapods -v 1.11.3
内容的提问来源于stack exchange，提问作者HBK
相关产品推荐
相关产品推荐
