iOS项目构建失败：reanimated命名空间无REAInitializer类型

核心原因 #

• 版本不兼容：expo-dev-launcher与react-native-reanimated版本不匹配。expo-dev-launcher的代码中引用了reanimated::REAInitializer，但当前安装的react-native-reanimated版本已移除或重命名该类，导致编译时找不到对应类型。
• iOS端缓存残留：仅清理node_modules和npm缓存不够，iOS的Pod依赖缓存、Xcode构建缓存仍可能保留旧的代码引用，导致错误持续存在。
• 条件编译判断失效：代码中的__has_include(<RNReanimated/REAInitializer.h>)判断误报头文件存在，但实际该头文件内已无REAInitializer类定义。

解决步骤 #

• 对齐依赖版本：查看expo-dev-launcher的官方兼容说明，安装与之匹配的react-native-reanimated版本。例如执行：

  npm install react-native-reanimated@兼容版本号
  

• 彻底清理iOS缓存：
  1. 删除iOS Pods目录和锁定文件：

     rm -rf ios/Pods ios/Podfile.lock
     

  2. 重新安装Pod依赖：

     cd ios && pod install
     

  3. 清理Xcode缓存：打开Xcode，按下Cmd+Shift+K清理构建文件夹，再按Cmd+Option+Shift+K清理派生数据。
• 临时应急方案（不推荐）：若无法立即调整版本，可临时注释掉node_modules/expo-dev-launcher/ios/EXRCTAppDelegateInterceptor.mm第63行的reanimated::REAInitializer(bridge);代码，但这可能导致react-native-reanimated初始化异常，仅作临时绕过使用。

内容的提问来源于stack exchange，提问作者Tươi Củ