React Native 0.78.0 iOS编译报错：'React/RCTAppSetupUtils.h'文件未找到

问题详情 #

升级至React Native 0.78.0后，iOS编译时出现错误提示：'React/RCTAppSetupUtils.h'文件未找到，编译日志显示xcodebuild退出码为65。

复现步骤 #

• 升级项目至React Native 0.78.0
• 执行npm install或yarn install安装依赖
• 通过Xcode编译或运行react-native run-ios命令

环境信息 #

• macOS 15.1
• Xcode 16.1
• CocoaPods 1.16.2
• iOS端启用Hermes与新架构

解决方案 #

1. 重新整合CocoaPods依赖 #

执行以下命令清理并重新安装Pods：

cd ios
pod deintegrate
pod clean
rm -rf Podfile.lock
cd ..
yarn install # 或 npm install
cd ios
pod install

若启用新架构，需添加环境变量重新安装：

cd ios
RCT_NEW_ARCH_ENABLED=1 pod install

2. 检查Xcode头文件搜索路径配置 #

打开Xcode，进入项目Target的Build Settings，找到Header Search Paths：

• 确保包含$(inherited)和$(SRCROOT)/Pods/Headers/Public/React
• 将上述路径的搜索方式设置为Recursive（递归）

3. 清理Xcode构建缓存 #

• 按Cmd+Shift+K清理Xcode构建文件夹
• 或手动删除DerivedData目录：

rm -rf ~/Library/Developer/Xcode/DerivedData

清理完成后重启Xcode再尝试编译。

4. 验证依赖版本一致性 #

• 检查package.json中react-native版本确认为0.78.0
• 执行yarn list react-native或npm list react-native，确认无依赖版本冲突

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