Xcode构建失败：文件路径过长超出缓冲区大小求助

问题根源 #

报错路径里出现SimplyMocktails.app/SimplyMocktails.app，说明构建过程中把生成的.app包本身又当成资源复制进了包内部，导致多层嵌套，最终触发路径长度超过系统限制（1025字符）。

具体修复步骤 #

• 检查Copy Bundle Resources列表
  进入目标的Build Phases > Copy Bundle Resources，仔细排查：

  • 有没有SimplyMocktails.app这个条目，有的话直接删除
  • 确认onboarding4.json是引用项目源码目录里的文件，不是从Build/DerivedData目录里添加的

• 核对Build Settings配置
  搜索以下配置项，确保设置正确：

  • COPY_PHASE_STRIP：Debug模式下设为NO
  • INSTALL_PATH：保持默认的$(LOCAL_APPS_DIR)，不要自定义指向构建产物的路径

• 彻底清理构建环境

  1. 直接删除对应的DerivedData目录：

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

  2. 关闭Xcode，终端执行命令重启模拟器服务：

     killall -9 com.apple.CoreSimulator.CoreSimulatorService
     

  3. 重新打开项目执行构建

• 验证文件引用和Target Membership

  • 右键onboarding4.json选择Show in Finder，确认文件在项目源码目录，而非构建产物目录
  • 查看文件的Target Membership，确保只勾选了主应用目标，没有误选其他可能导致重复复制的目标

内容的提问来源于stack exchange，提问作者brandon aho