React Native + Expo项目Xcode构建报错：No such module 'ExpoModulesCore'

• 清理依赖与重置Expo预构建

  1. 删除本地依赖缓存与锁文件：rm -rf node_modules package-lock.json yarn.lock
  2. 重新安装项目依赖：npm install 或 yarn install
  3. 清理并重新生成iOS项目配置：npx expo prebuild --clean

• 重置Pods环境

  1. 进入iOS目录：cd ios
  2. 删除Pods目录与锁文件：rm -rf Pods Podfile.lock
  3. 更新Pod仓库并重新安装：pod install --repo-update

• 检查Xcode构建路径配置

  1. 打开Xcode，选中项目Target，进入「Build Settings」面板
  2. 搜索「Framework Search Paths」，确认包含以下路径（设置为Recursive）：
     • $(inherited)
     • $(PROJECT_DIR)/Pods/ExpoModulesCore
  3. 搜索「Header Search Paths」，添加以下路径（设置为Recursive）：
     • $(inherited)
     • $(SRCROOT)/../node_modules/expo-modules-core/ios

• 验证Expo Modules配置完整性

  1. 确认Podfile顶部已添加：require_relative '../node_modules/expo-modules-autolinking/scripts/podfile-utils'，并在合适位置调用use_expo_modules!
  2. 检查ios/Pods/ExpoModulesCore目录下是否存在ExpoModulesCore.xcframework，若缺失则重新执行pod install

• 清理Xcode构建缓存

  1. 关闭Xcode，执行命令删除DerivedData：rm -rf ~/Library/Developer/Xcode/DerivedData
  2. 重新打开Xcode，执行「Clean Build Folder」（快捷键Cmd+Shift+K），再尝试重新构建项目（Cmd+B）

• 确认版本匹配
  确保expo-modules-core版本与Expo版本严格匹配，当前Expo 51对应1.12.25版本，可重新安装该包：npm install expo-modules-core@1.12.25

内容的提问来源于stack exchange，提问作者Damien Borgniet