Mac端React Native项目iOS Simulator无法启动问题求助

一、Node 18环境下npx react-native run-ios无响应的排查步骤 #

• 先手动启动iOS模拟器：打开Xcode，点击顶部菜单Window -> Devices and Simulators，选中一个模拟器启动后，再执行npx react-native run-ios --verbose，通过控制台输出定位具体错误（未加--verbose会隐藏关键日志）
• 清理项目缓存与依赖：

  rm -rf node_modules && npm install
  cd ios && rm -rf Pods Podfile.lock && bundle exec pod install --repo-update && cd ..
  npx react-native clean
  

• 验证React Native版本兼容性：确保package.json中react-native版本为0.71+（该版本开始正式支持Node 18），若版本过低，升级至0.71.x或更高分支
• 确认Xcode命令行工具路径：执行xcode-select -p，若输出路径不正确，执行sudo xcode-select -s /Applications/Xcode.app/Contents/Developer修正

二、Node 16.14下Bundler安装失败（Gem::Ext::BuildError）的解决 #

• 安装Ruby依赖工具并配置环境变量（以zsh为例）：

  brew install openssl readline
  echo 'export PATH="/usr/local/opt/openssl/bin:$PATH"' >> ~/.zshrc
  echo 'export LDFLAGS="-L/usr/local/opt/openssl/lib"' >> ~/.zshrc
  echo 'export CPPFLAGS="-I/usr/local/opt/openssl/include"' >> ~/.zshrc
  echo 'export RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl)"' >> ~/.zshrc
  source ~/.zshrc
  

• 使用rbenv管理Ruby版本（推荐）：

  rbenv install 2.7.6
  rbenv global 2.7.6
  

• 手动指定Bundler版本安装：

  gem install bundler:2.3.26
  cd ios && bundle install
  

三、macOS 13.4适配的React Native环境兼容版本清单 #

四、优化模拟器启动速度的技巧 #

• 关闭Xcode自动索引：打开Xcode -> Settings -> Locations，删除当前项目的Derived Data目录；再进入Product -> Scheme -> Edit Scheme -> Build，取消勾选Index-While-Building
• 禁用模拟器动画：打开模拟器 -> Settings -> Developer，开启Reduce Motion和Limit Frame Rate

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