Mac M1 Pro执行pod install报错Podfile无效无法加载react_native_pods

报错现象 #

在搭载M1 Pro芯片的Mac设备上于React Native项目ios目录执行pod install时流程中断，核心报错信息：

[!] Invalid Podfile file: cannot load such file -- /Users/hirenchheta/Desktop/ErgoAuditor_repo/node_modules/react-native/scripts/react_native_pods.
报错定位：/Users/hirenchheta/Desktop/ErgoAuditor_repo/ios/Podfile 第1行
对应触发报错的Podfile头部代码：

require_relative '../node_modules/react-native/scripts/react_native_pods'
require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'

报错逻辑为Podfile解析阶段无法匹配到引用路径下的RN核心脚本文件，直接终止安装流程。

触发原因 #

• 项目根目录node_modules依赖安装不完整，React Native核心包缺失，对应脚本文件不存在
• M1系列芯片下CocoaPods、Node.js运行架构不统一（部分工具跑x86转译、部分跑原生arm），导致依赖安装时漏装核心组件
• 执行命令时路径不对，或者文件权限不足导致脚本无法被读取

修复步骤 #

按顺序执行以下操作即可解决：

1. 切到项目根目录（和ios、node_modules文件夹同级的路径，不要在ios目录下执行前端依赖命令），清理所有旧的安装残留：

# 删除前端依赖和锁文件
rm -rf node_modules
rm -f package-lock.json yarn.lock pnpm-lock.yaml
# 清理CocoaPods旧缓存
cd ios
rm -rf Pods Podfile.lock
cd ..

2. 统一M1芯片下的运行环境：
   • 找到你用的终端App（系统终端/iTerm2等），右键选择「显示简介」，勾选「使用Rosetta打开」后重启终端
   • 重新安装匹配架构的CocoaPods：执行sudo gem install cocoapods，等待安装完成
3. 重新安装前端依赖，根据你项目用的包管理器选对应命令：

npm install
# 用yarn就执行 yarn install
# 用pnpm就执行 pnpm install

安装完成后可以手动打开node_modules/react-native/scripts/目录，确认里面存在react_native_pods.rb文件，存在就说明前端依赖装全了
4. 切到ios目录重新执行pod安装：

cd ios
arch -x86_64 pod install

如果已经把整套开发环境都适配了原生arm架构，直接执行pod install也可以。
如果按步骤操作完还是报相同错误，先检查你当前打开的项目文件夹路径和报错里的路径是否一致，避免开错项目目录做无用功。

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