Xcode SPM包可正常运行却提示Workspace integrity error

问题现状 #

现有集成Swift代码与JSON资源的SPM框架，Package.swift配置如下：

let package = Package(
    name: "MyTestData",
    products: [
        .library(
            name: "MyTestData",
            targets: ["MyTestData"]
        ),
    ],
    targets: [
        .target(
            name: "MyTestData",
            dependencies: [],
            path: "Sources",
            sources: ["ios"],
            resources: [
                .copy("payloads"),
                .copy("snippets"),
            ]
        ),
    ]
)

当前异常表现：

• SPM依赖解析正常，代码编译、运行全流程功能正常
• Xcode弹出工作区完整性错误，报错指向payloads、snippets两个目录
• 调整path/sources/exclude/resources字段配置后仅出现两种结果：要么报错保留但功能正常，要么报错消失但项目运行失败
• 依赖解析日志、构建日志均无对应错误提示

触发原因 #

这个问题本质是SPM构建时的路径解析规则和Xcode静态工作区校验逻辑不一致导致的：

1. 按SPM的规则，给target指定path: "Sources"后，这个路径就是target的根目录，后续sources、resources、exclude字段的所有路径都相对于这个根目录解析。配置sources: ["ios"]只是告诉构建系统「仅编译Sources/ios下的源码文件」，resources里声明的两个目录，构建系统会直接从Sources根目录查找，只要能找到就会正常打包进产物，所以项目编译、运行全流程都不会出问题。
2. Xcode的工作区完整性校验逻辑没有和SPM构建逻辑对齐：当你显式声明sources的子集范围后，校验逻辑会默认判定Sources下除了sources列出的路径外，其他内容都不属于当前target，哪怕你已经在resources里声明了这两个目录，校验逻辑还是会抛错。如果为了消掉报错把资源路径改成相对于ios目录的写法，校验逻辑能通过，但构建系统依然会从Sources根目录查找资源，找不到文件自然就会运行失败。
3. 这个是Xcode 13到16部分版本的已知逻辑缺陷，静态校验的报错不会阻断实际构建流程，才会出现「报错存在但功能完全正常」的反常现象。

修复方案 #

根据实际目录结构二选一即可：

方案1：资源目录和ios目录同级（都在Sources下） #

即目录结构为：

MyTestData
└── Sources
    ├── ios/        // 存放Swift源码
    ├── payloads/   // 存放JSON资源
    └── snippets/   // 存放JSON资源

直接删除target配置里的sources: ["ios"]字段即可。SPM默认会递归扫描path指定目录下的所有Swift文件作为源码，自动忽略resources中声明的资源目录，不需要手动限定源码范围。修改后Xcode校验逻辑和SPM构建逻辑的路径判断完全一致，既不会弹出完整性错误，也能正常编译运行。
如果确实需要保留sources字段做源码范围裁剪，这个工作区完整性错误属于无害提示，不会影响包的功能、归档和提交，直接忽略即可。

方案2：资源目录放在ios目录内部 #

即目录结构为：

MyTestData
└── Sources
    └── ios/
        ├── （Swift源码文件）
        ├── payloads/
        └── snippets/

修改resources的路径为相对于target根目录的完整路径即可，修正后的配置：

resources: [
    .copy("ios/payloads"),
    .copy("ios/snippets"),
]

修改后构建系统和Xcode校验逻辑都能在正确路径找到资源，报错消失，运行时也能正常访问JSON文件。

注：JSON这类不需要编译处理的资源用.copy即可，如果需要构建时自动压缩优化JSON体积，可替换为.process，资源访问逻辑不受影响。

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