如何让Swift Package Manager忽略临时文件且不触发Invalid Exclude报错

问题原因 #

SPM 的 exclude 配置要求所有列出的路径必须在构建执行时真实存在，设计初衷是排除明确的、固定存在的非源码文件，不支持匹配不存在的文件或通配符规则，因此无法直接当成 .gitignore 使用。

解决方案 #

方案1：依托.gitignore自动忽略（最推荐）

Swift 5.3 及以上版本的 SPM 会自动读取目标源码目录下的 .gitignore 规则，匹配的文件会自动被排除在构建流程之外，无需手动在 Package.swift 中声明，也不会因为文件不存在抛出报错。
操作步骤：

• 在目标源码目录（示例中为 Sources/SchemeC/）新建 .gitignore 文件
• 写入你需要忽略的规则，示例：

*.o
TAGS*
Makefile
s7repl

• 删掉 Package.swift 的 exclude 列表中对应的临时文件条目即可。

方案2：动态生成exclude列表（兼容旧版本SPM）

Package.swift 本身是可执行的 Swift 代码，你可以通过文件状态判断动态生成排除列表，仅将真实存在的文件加入排除项：

import Foundation
import PackageDescription

let package = Package(
    name: "SchemeC",
    targets: [
        .target(
            name: "SchemeC",
            exclude: {
                var excludes = [String]()
                let sourceDir = URL(fileURLWithPath: #filePath)
                    .deletingLastPathComponent()
                    .appendingPathComponent("Sources/SchemeC")
                // 所有可能需要排除的候选文件
                let candidateExcludes = [
                    "s7repl.o",
                    "s7sqlite.o",
                    "s7.o",
                    "TAGS.scheme",
                    "Makefile"
                ]
                for candidate in candidateExcludes {
                    let filePath = sourceDir.appendingPathComponent(candidate).path
                    if FileManager.default.fileExists(atPath: filePath) {
                        excludes.append(candidate)
                    }
                }
                return excludes
            }()
        )
    ]
)

方案3：统一收纳临时文件到固定目录

将所有开发阶段生成的临时文件、测试工具都输出到一个固定的、永久存在的目录下，比如 Sources/SchemeC/dev-temp/，直接在 exclude 列表中排除整个目录即可：

.target(
    name: "SchemeC",
    exclude: ["dev-temp"]
)

只要目录本身存在，不管内部有没有文件、有什么文件，SPM都不会报错，也不会将目录下的内容纳入构建流程。

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