M1 Mac启动新React Native项目失败，依赖冲突求助

一、彻底清除全局旧版React Native #

• 先检查全局已安装的相关包：

  npm list -g react-native
  

  若用yarn管理依赖，执行：

  yarn global list react-native
  

• 卸载全局的React Native及配套CLI工具：

  npm uninstall -g react-native react-native-cli @react-native-community/cli
  

  yarn用户执行：

  yarn global remove react-native react-native-cli @react-native-community/cli
  

• 清理包管理器缓存，避免残留文件干扰：

  npm cache clean --force
  

  yarn用户执行：

  yarn cache clean
  

二、清理本地项目残留 #

如果之前创建过失败的项目（比如AwesomeProject），直接删除整个项目文件夹：

rm -rf AwesomeProject

三、创建最新版React Native项目 #

• 直接用npx拉取最新版本创建项目，无需全局安装：

  npx react-native init AwesomeProject --latest
  

• 若仍出现依赖冲突，添加--legacy-peer-deps参数兼容旧版peer依赖解析规则：

  npx react-native init AwesomeProject --latest --legacy-peer-deps
  

• 验证安装：进入项目目录，启动iOS模拟器测试（M1芯片需确保模拟器支持或终端开启Rosetta）：

  cd AwesomeProject
  npx react-native run-ios
  

四、额外排查方案 #

• 检查Node.js版本是否符合React Native最新要求，建议使用LTS版本（如16.x或18.x），可通过nvm快速切换：

  nvm install --lts
  nvm use --lts
  

• M1芯片用户若遇兼容性问题，可右键终端应用→显示简介→勾选「使用Rosetta打开」后重启终端再操作

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