Xcode调整项目文件位置后无法归档，如何手动更新文件路径？

检查项目文件引用路径 #

• 打开项目的.xcodeproj/.xcworkspace，在左侧导航栏选中移动过的文件，查看右侧File Inspector面板里的Location选项：
  • 确保路径类型是Relative to Project或Relative to Group，避免使用绝对路径
  • 如果路径显示错误，点击路径旁的文件夹图标，重新选择文件的实际存放位置

彻底清理项目缓存 #

• 按下Cmd + Shift + K清理当前构建文件夹
• 按下Cmd + Option + Shift + K彻底清理Xcode缓存
• 关闭Xcode，找到项目对应的DerivedData文件夹（可通过Xcode偏好设置Preferences > Locations查看路径），直接删除整个文件夹

检查Build Settings中的路径配置 #

• 选中项目Target，进入Build Settings标签页：
  • 搜索Header Search Paths、Library Search Paths，删除其中无效的旧路径，或更新为文件移动后的新相对路径
  • 若移动了框架文件，同步检查Framework Search Paths，确保路径正确

同步Git文件跟踪状态 #

• 打开终端进入项目目录，执行git status查看路径变更记录
• 执行git add .更新Git对文件新路径的跟踪，随后提交变更：git commit -m "update file paths after moving files"
• 若存在Git未跟踪的冗余缓存文件，可执行git clean -fd清理（注意：此命令会删除未加入Git的文件，执行前确认无需要保留的内容）

检查归档Scheme配置 #

• 点击Xcode顶部Scheme下拉菜单，选择Edit Scheme
• 进入Archive选项卡，确认Build Configuration与正常构建时一致（例如均为Release），避免归档时使用了单独配置的路径参数

最后验证 #

• 重启Xcode并重新打开项目，先执行一次正常构建（Cmd + B）确认无错误，再尝试归档操作（Product > Archive）

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