Xcode清理构建文件夹后本地SPM模块找不到，重复构建才解决

可能的操作失误 #

• 本地包路径基准错误：相对路径的解析基准是**工作区文件（.xcworkspace）**的位置，而非项目文件（.xcodeproj）。如果你的路径声明是基于项目位置写的，会导致Xcode首次构建时找不到包。
• 包与目标的依赖关联不完整：添加SPM包后未在目标的依赖设置中勾选关联，或包间依赖在Package.swift中声明遗漏，导致Xcode误判“包未被任何目标使用”。
• 工作区构建顺序问题：主项目优先于本地SPM包构建，首次构建时包未完成编译，触发“no such module”错误。

修复步骤 #

1. 修正本地SPM包的路径声明 #

打开项目的Package Dependencies设置（或工作区的Package.swift），确认本地包的相对路径是相对于工作区文件的位置：

• 例如工作区路径为/Projects/MyWorkspace/MyWorkspace.xcworkspace，本地包在/Projects/CoreGraphicsExtensions，则正确声明为：

  .package(url: "file:../CoreGraphicsExtensions", from: "0.0.0")
  

• 若项目文件在工作区子目录（如/Projects/MyWorkspace/BlenderViewer），需调整路径为file:../../CoreGraphicsExtensions，确保路径解析正确。

2. 完善包与目标的依赖关联 #

• 进入项目的Project > Package Dependencies，选中每个本地SPM包，在右侧Add to Targets中勾选你的构建目标（如BlenderViewer的iOS目标）。
• 检查每个本地包的Package.swift，确认targets中的dependencies正确声明包间依赖，例如：

  targets: [
      .target(name: "CoreGraphicsExtensions", dependencies: []),
      .target(name: "ImageProcessingTools", dependencies: ["CoreGraphicsExtensions"]),
  ]
  

• 进入目标的Build Phases > Link Binary With Libraries，确认所有本地SPM包的框架已添加（Swift包通常自动添加，手动检查避免遗漏）。

3. 强制调整工作区构建顺序 #

• 打开工作区，选择File > Workspace Settings，切换到Build标签页。
• 点击Add Build Phase > Add Pre-action，选择你的构建目标，添加脚本强制先编译所有本地SPM包：

  xcodebuild -workspace "${WORKSPACE_PATH}" -scheme "CoreGraphicsExtensions" build
  xcodebuild -workspace "${WORKSPACE_PATH}" -scheme "ImageProcessingTools" build
  # 依次添加剩余4个本地包的scheme编译命令
  

  注意：确保每个本地包都有对应的scheme（可通过Product > Scheme > Manage Schemes生成）。

4. 重置Xcode缓存与索引 #

关闭Xcode后执行以下操作，清除异常缓存：

• 删除DerivedData目录：rm -rf ~/Library/Developer/Xcode/DerivedData
• 删除工作区的xcuserdata目录：找到MyWorkspace.xcworkspace/xcuserdata并删除
• 重新打开Xcode，执行Clean Build Folder（⇧⌘K）后尝试首次构建。

5. 检查包的版本声明 #

确保每个本地SPM包的Package.swift中version字段与依赖声明的范围兼容，例如：

let package = Package(
    name: "CoreGraphicsExtensions",
    platforms: [.iOS(.v15)],
    version: "0.0.1", // 需满足依赖声明的from: "0.0.0"范围
    products: [
        .library(name: "CoreGraphicsExtensions", targets: ["CoreGraphicsExtensions"]),
    ],
    // ...
)

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