升级macOS 15 Sequoia后React Native项目CocoaPods安装失败求助
解决方案
1. 清理旧版CocoaPods及残留
先卸载所有现有CocoaPods安装并清理缓存:
# 卸载Homebrew版本的CocoaPods brew uninstall cocoapods --force # 卸载系统gem安装的CocoaPods(需输入密码) sudo gem uninstall cocoapods --all # 删除CocoaPods缓存目录 rm -rf ~/.cocoapods
2. 安装兼容的新版Ruby
macOS 15自带的Ruby 2.6.10版本过低,直接通过Homebrew安装新版Ruby:
brew install ruby
3. 配置环境变量优先使用Homebrew Ruby
编辑zsh配置文件(~/.zshrc),将Homebrew Ruby的路径加入系统PATH最前端:
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc echo 'export PATH="/opt/homebrew/lib/ruby/gems/3.3.0/bin:$PATH"' >> ~/.zshrc
生效配置:
source ~/.zshrc
验证Ruby版本(需显示3.x及以上):
ruby -v
4. 重新安装CocoaPods
选择以下一种方式安装:
方式一:通过gem安装
gem install cocoapods
方式二:通过Homebrew安装(更稳定)
brew install cocoapods
5. 验证并修复React Native项目
验证CocoaPods安装成功:
pod --version
进入你的React Native项目目录,重新执行pod安装:
cd your-project-directory npx pod-install ios
额外检查
如果仍有问题,确保Xcode命令行工具已正确安装:
xcode-select --install
内容的提问来源于stack exchange,提问作者Jaime Andrés Avendaño Villa
相关产品推荐
相关产品推荐

