首次使用Mac搭建React Native项目失败，求助iOS环境配置问题

步骤1：确保CocoaPods与rbenv Ruby版本正确关联 #

• 先确认终端当前使用的Ruby版本是2.7.5：

  ruby -v
  

  如果输出不是2.7.5，执行以下命令切换版本并重启终端：

  rbenv global 2.7.5
  

• 卸载旧版CocoaPods，用当前Ruby重新安装：

  sudo gem uninstall cocoapods
  gem install cocoapods
  

• 初始化CocoaPods仓库（耗时较长，耐心等待）：

  pod setup
  

步骤2：清理残留后重新初始化项目 #

• 删除已创建的project_adji文件夹
• 清理npm缓存：

  npm cache clean --force
  

• 重新执行初始化命令，指定iOS源码目录避免多Podfile冲突：

  npx react-native init project_adji --template react-native-template-typescript --project-ios-sourceDir ios
  

步骤3：手动安装iOS依赖（自动安装失败时） #

• 进入项目的iOS目录：

  cd project_adji/ios
  

• 清理旧的Pod依赖文件：

  rm -rf Podfile.lock Pods
  pod deintegrate
  

• 重新安装Pods：

  pod install
  

  如果遇到权限问题，可尝试：

  sudo pod install
  

步骤4：验证iOS开发环境完整性 #

• 确保Xcode已安装并更新至最新稳定版，首次打开需同意协议并完成初始化配置
• 检查Xcode命令行工具：打开Xcode -> 偏好设置 -> 位置，确认已选择对应版本的Command Line Tools
• 安装Node.js和Watchman（若未安装）：

  brew install node watchman
  

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