React Native项目Android正常，iOS报React-Codegen相关构建错误

以下是针对新RN项目iOS端出现的React-Codegen依赖停滞、Command PhaseScriptExecution失败问题的实用解决方案：

• 清理依赖缓存并重装
  彻底清理npm和Pods的缓存与旧文件，重新构建依赖链：

  # 清理npm缓存
  npm cache clean --force
  # 删除本地依赖文件与锁文件
  rm -rf node_modules package-lock.json yarn.lock
  # 重装npm依赖
  npm install
  # 进入iOS目录清理Pods
  cd ios
  rm -rf Pods Podfile.lock
  pod deintegrate
  # 更新Pod仓库并重装Pods
  pod install --repo-update
  

• 检查Xcode配置与系统权限

  • 确保使用最新稳定版Xcode，打开项目时选择匹配的开发者签名（个人账号直接选自己的签名即可）
  • 打开Xcode项目，右键点击Pods文件夹下的React-Codegen → 选择Build Phases，检查Generate Specs脚本的路径是否正确，若有红标错误，手动修正为项目根目录相对路径
  • 给终端开启完全磁盘访问权限：进入系统设置 → 隐私与安全性 → 完全磁盘访问权限，添加你使用的终端工具（Terminal/iTerm等）

• 手动执行Codegen生成命令
  自动生成失败时，手动触发Codegen的spec生成：

  cd ios
  ../node_modules/.bin/react-native-codegen generate-specs --platform ios --project-root ../ --output-dir ./build/generated/ios
  

  执行完成后重新运行pod install，再在Xcode中按Cmd+Shift+K清理构建文件夹，最后重新构建项目

• 调整React Native版本（可选）
  若当前RN版本存在Codegen已知bug，尝试切换到官方稳定版本：

  npm install react-native@0.72.6 # 替换为当前最新稳定版号
  cd ios
  pod install
  

• 验证Node.js版本兼容性
  确保Node.js版本符合RN官方要求（RN 0.7x系列要求Node 16+），可通过nvm快速切换：

  nvm install 18
  nvm use 18
  

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