M1 Mac创建React Native 0.72.3项目遇Ruby/CocoaPods错误求助

一、彻底清理React Native相关缓存 #

• 清理npx缓存：npx clear-npx-cache
• 清理React Native全局缓存：rm -rf ~/.npm/_npx
• 删除残留项目文件（如果有未清理干净的myApp文件夹）：rm -rf myApp

二、指定匹配版本初始化项目 #

直接用npx react-native init可能会拉取最新版CLI，和0.72.3项目版本不兼容，需同时指定CLI和项目版本：

npx react-native@0.72.3 init myApp --version 0.72.3

三、修复M1 Mac下Ruby与CocoaPods的架构兼容问题 #

M1芯片的架构差异常导致CocoaPods报错，按以下步骤处理：

1. 用Rosetta打开终端：右键终端图标→显示简介→勾选「使用Rosetta打开」，重启终端
2. 重新安装指定版本的CocoaPods：

   sudo gem uninstall cocoapods
   sudo gem install cocoapods -v 1.14.3
   

3. 清理CocoaPods缓存：

   pod cache clean --all
   rm -rf ~/Library/Caches/CocoaPods
   

四、初始化后手动修复iOS依赖 #

如果初始化完成后iOS端仍报错，进入项目iOS目录重新安装依赖：

cd myApp/ios
rm -rf Pods Podfile.lock
pod install --repo-update

若遇到Flipper版本冲突，修改Podfile中的Flipper版本为0.72.3适配的0.182.0：

use_flipper!({ 'Flipper' => '0.182.0' })

修改后再次执行pod install

五、验证基础依赖版本 #

React Native 0.72.3要求Node.js 16+、Watchman 4.9+：

• 检查Node版本：node -v，版本过低的话用nvm切换到16.x稳定版（比如16.20.2）
• 检查Watchman版本：watchman version，版本不足则执行brew update && brew upgrade watchman

六、最后重试运行 #

确保所有缓存清理完成后，重新执行初始化命令，完成后尝试启动项目：

cd myApp
npx react-native run-ios

如果出现Xcode签名错误，打开myApp/ios/myApp.xcworkspace，检查签名配置并选择正确的开发团队，同时确认Xcode偏好设置→Locations中的Command Line Tools为最新稳定版。

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