iOS项目使用React Navigation报错RNSScreenStackHeaderConfig未找到求助

该报错由createNativeStackNavigator的底层原生依赖缺失导致：你使用的原生堆栈导航器依赖react-native-screens库提供的RNSScreenStackHeaderConfig等原生组件，仅安装react-navigation核心包未完成全量依赖安装、或iOS端未同步原生依赖都会触发该错误。

按顺序执行以下操作即可修复：

• 安装缺失依赖
  普通React Native项目执行：

  # npm 安装
  npm install react-native-screens react-native-safe-area-context
  # yarn 安装
  yarn add react-native-screens react-native-safe-area-context
  

  Expo项目执行：

  npx expo install react-native-screens react-native-safe-area-context
  

• 同步iOS原生依赖（仅普通React Native项目需要，Expo项目跳过）
  进入ios目录执行pod安装：

  cd ios && pod install && cd ..
  

• 全量编译重启项目
  完全关闭当前运行的Metro服务和iOS应用，重新执行启动命令编译项目：

  # 普通项目
  npx react-native run-ios
  # Expo项目
  npx expo start --clear
  

  注意：原生依赖变更不可直接使用热更新重载，必须全量编译才能生效。

如果上述操作后仍报错，可按以下场景排查：

• 若你使用的是React Native 0.60以下版本，需要额外执行react-native link react-native-screens react-native-safe-area-context完成手动链接
• 若你开启了React Native新架构（Fabric），需将react-native-screens升级到3.18.0及以上的支持版本
• 清理缓存重试：执行npx react-native start --reset-cache重启Metro，同时清理Xcode构建缓存后重新编译

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