React Native项目启动Cocoapods安装问题求助

一、彻底修复Cocoapods安装问题 #

Pod安装失败是核心诱因，先解决这个问题：

• 卸载残留的Cocoapods和相关文件：

  sudo gem uninstall cocoapods
  rm -rf ~/.cocoapods
  

• 用rbenv管理Ruby版本（规避系统Ruby权限冲突）：
  1. 安装rbenv：brew install rbenv ruby-build
  2. 配置终端环境变量（zsh用户执行）：

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

     执行完重启终端，让配置生效
  3. 安装React Native官方推荐的Ruby版本（比如3.2.2）：

     rbenv install 3.2.2
     rbenv global 3.2.2
     

     执行ruby -v确认版本切换成功
  4. 重新安装Cocoapods：gem install cocoapods，再执行pod setup完成初始化

二、重新初始化iOS项目依赖 #

• 进入iOS目录清理旧依赖：

  cd "/Users/rabiegharghar/Desktop/react native/app/ios"
  rm -rf Pods Podfile.lock
  pod deintegrate
  

• 重新安装Pod依赖：pod install
• 注意：之后启动项目必须打开ios/[你的项目名].xcworkspace文件，不能用.xcodeproj

三、模拟器启动失败的额外排查 #

如果Pod装好后还是启动失败，做这些检查：

• 打开Xcode，进入Settings -> Platforms，确保iOS模拟器是最新版本，无更新提示
• 清理React Native项目缓存：

  cd ..
  npx react-native clean
  

  清理完回到iOS目录重新执行pod install
• 直接用Xcode打开.xcworkspace文件，点击运行按钮，查看Xcode控制台的具体报错信息（比如签名配置错误、依赖库缺失，Xcode会给出明确提示）

内容的提问来源于stack exchange，提问作者Rabie gh