React Native新项目创建后无法启动，寻求技术帮助

• 确认环境依赖达标

  • 检查Node.js版本：执行node -v，确保是React Native官方要求的稳定版本（推荐16.x及以上）
  • 检查Java SDK（Android开发）：执行java -version，React Native 0.68+要求使用JDK 11
  • 检查Xcode（iOS开发）：确保是最新稳定版，且已安装Command Line Tools（可通过xcode-select --install安装）

• 清除缓存并重装依赖

  • 删除项目根目录的node_modules：rm -rf node_modules（Mac/Linux）或rd /s /q node_modules（Windows）
  • 清空包管理器缓存：npm cache clean --force（npm）或yarn cache clean（yarn）
  • 重新安装依赖：npm install或yarn install
  • 重置React Native缓存：npx react-native start --reset-cache

• 定位具体错误

  • 启动项目时保留终端窗口，仔细查看输出的错误提示，比如端口被占用、依赖缺失、配置文件错误等
  • Android端可通过Android Studio的Logcat，iOS端通过Xcode控制台查看更详细的报错信息，精准定位问题

• Android端额外处理

  • 打开Android Studio的SDK Manager，确认对应版本的SDK Platform、Build Tools已安装完整
  • 进入android目录，执行./gradlew clean清除构建缓存，返回根目录后重新启动项目

• iOS端额外处理

  • 进入ios目录，执行pod install重新安装CocoaPods依赖
  • 打开Xcode，按Command+Shift+K清理项目，再重新构建运行

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