Expo eject后React Native iOS构建失败：Yoga文件路径缺失报错

这个问题我之前帮好几个开发者解决过，是Expo eject转纯React Native后很常见的路径配置问题——Xcode在构建时找不到Yoga库的正确位置，才会报那些PBXCp复制文件失败的错误。下面给你一步步的修复方案：

1. 先清理旧构建产物和缓存 #

首先把残留的构建文件、Pod缓存都清干净，避免旧配置干扰：

• 先关掉Xcode，手动删除iOS项目下的build文件夹（路径是ios/build）
• 打开终端，执行以下命令清理依赖缓存：

  # 进入iOS目录
  cd ios
  # 移除现有Pod集成
  pod deintegrate
  # 清理Pod缓存
  pod clean
  # 删除Pod锁文件
  rm -rf Podfile.lock
  # 返回项目根目录，重装Node依赖
  cd ..
  rm -rf node_modules
  npm install # 用yarn的话就执行 yarn install
  

2. 检查并修复Podfile配置 #

Eject后的Podfile经常会出现Yoga引用缺失或者路径错误的情况。打开ios/Podfile，确保里面包含正确的React和Yoga依赖配置：

# 引入React Native核心依赖，根据你的RN版本调整subspecs
pod 'React', :path => '../node_modules/react-native/', :subspecs => [
  'Core',
  'CxxBridge',
  'DevSupport', # 开发环境需要，打包时可以注释
  'RCTText',
  'RCTNetwork',
  'RCTWebSocket', # 调试热重载需要
  # 其他你项目用到的subspecs，比如RCTImage等
]
# 确保Yoga的路径是指向node_modules里的正确位置
pod 'yoga', :path => '../node_modules/react-native/ReactCommon/yoga'

配置好后，回到终端重新安装Pods：

cd ios
pod install

3. 修正Xcode的头文件搜索路径 #

如果上面的步骤没解决问题，大概率是Xcode的头文件搜索路径配置错了：

• 打开ios/TrackUs.xcworkspace（注意一定要用xcworkspace，不是xcodeproj）
• 在左侧项目导航栏选中你的根目标TrackUs，切换到Build Settings标签
• 在搜索框输入Header Search Paths，找到对应的设置项
• 添加以下两个路径，并且把它们的搜索模式改成recursive（递归搜索）：

  $(SRCROOT)/../node_modules/react-native/ReactCommon/yoga
  $(SRCROOT)/../node_modules/react-native/React
  

4. 检查Xcode中的Yoga项目引用 #

有时候eject过程中，Xcode里的Yoga项目引用会变成无效的绝对路径（比如你报错里的~/ReactCommon/...这种错误路径），需要重新添加：

• 在Xcode左侧的Libraries文件夹上右键，选择Add Files to "TrackUs"
• 找到node_modules/react-native/ReactCommon/yoga/Yoga.xcodeproj，添加到项目中
• 然后选中新添加的Yoga.xcodeproj，检查它的Build Phases里的Copy Files任务，确保输出路径是正确的；如果有旧的无效Copy任务，直接删掉就行，Pods会自动处理文件复制

5. 最后重新构建 #

做完上面的步骤后，回到Xcode，选择对应的模拟器或真机，点击构建按钮试试。如果还是有问题，可以打开Xcode的Report Navigator（左侧最后一个图标），查看更详细的错误日志，看看是不是还有其他路径相关的问题。

内容的提问来源于stack exchange，提问作者King J