React-Native项目初始化失败：CocoaPods依赖安装报错排查

1. 验证CocoaPods环境变量配置 #

虽然你已安装CocoaPods，但react-native cli可能无法识别到它的路径：

• 执行以下命令查看当前PATH：

  echo $PATH
  

• 确认输出中包含CocoaPods的安装路径（通常是/usr/local/bin或~/.rbenv/shims，取决于Ruby版本管理工具）
• 如果路径缺失，手动添加并生效：

  # 假设使用rbenv，根据实际情况调整路径
  export PATH="$HOME/.rbenv/shims:$PATH"
  source ~/.zshrc # 若使用bash则替换为source ~/.bashrc
  

2. 清理CocoaPods缓存与项目残留文件 #

缓存或残留文件可能导致安装失败：

• 清理全局CocoaPods缓存：

  pod cache clean --all
  

• 进入项目的ios目录，删除旧的依赖文件：

  cd Test/ios
  rm -rf Podfile.lock Pods
  

3. 手动执行CocoaPods安装 #

跳过react-native cli的自动安装流程，手动处理iOS依赖：

• 继续在ios目录下执行：

  pod install --repo-update
  

--repo-update参数会强制更新CocoaPods仓库，避免依赖版本不兼容问题。

4. 检查Ruby版本兼容性 #

CocoaPods 1.11.3要求Ruby版本在2.6及以上：

• 查看当前Ruby版本：

  ruby --version
  

• 若版本过低，使用rbenv或rvm升级Ruby到符合要求的版本（比如2.7.x），再重新执行pod install。

5. 跳过自动安装重新初始化项目 #

如果以上方法无效，尝试跳过cli的自动依赖安装：

• 删除现有项目：

  rm -rf Test
  

• 初始化时跳过自动安装：

  npx react-native init Test --skip-install
  

• 进入ios目录手动安装依赖：

  cd Test/ios
  pod install
  

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