使用SPM获取本地文件URL：Swift Package单元测试读取JSON文件问题

这个问题确实是Swift Package和传统iOS/macOS项目的核心差异导致的——Swift Package的测试目标不会自动将资源文件纳入Bundle，而且完全不能用Bundle.main来获取资源，得用测试目标专属的Bundle来访问。下面是具体的解决步骤：

第一步：在Package.swift中配置测试目标的资源 #

你需要修改testTarget的配置，添加resources参数来明确指定要包含的资源文件。比如如果你的JSON文件放在测试目录（Tests/ProjectTests）下，或者它的子目录里，可以这样调整：

.testTarget(
    name: "ProjectTests",
    dependencies: [ .target(name: "Project") ],
    path: "Tests",
    exclude: [ "Folder/File.swift" ],
    resources: [
        // 方式1：包含测试目标目录下的所有资源（资源不多时推荐）
        .process("."),
        // 方式2：如果资源放在专属的Resources子目录，就指定这个目录
        // .process("Resources")
    ]
)

process会自动处理目标目录下的所有资源文件，把它们打包到测试目标的专属Bundle中。

第二步：在测试代码中正确获取资源URL #

彻底放弃Bundle.main，换成测试目标的Bundle，有两种简单好用的方式：

方式1：通过测试类的类型获取Bundle #

在你的测试方法里，用当前测试类的类型来定位对应的Bundle：

func testReadJSONFile() {
    let filename = "yourFileName" // 替换成你的JSON文件名（不带后缀）
    let testBundle = Bundle(for: type(of: self))
    
    guard let jsonURL = testBundle.url(forResource: filename, withExtension: "json") else {
        XCTFail("找不到文件 \(filename).json")
        return
    }
    
    // 接下来就可以用jsonURL读取文件内容了
    do {
        let data = try Data(contentsOf: jsonURL)
        // 解析数据...
    } catch {
        XCTFail("读取JSON文件失败：\(error.localizedDescription)")
    }
}

方式2：使用自动生成的Bundle.module（更简洁） #

Swift Package会为每个目标自动生成Bundle.module属性，直接用它就能访问当前测试目标的Bundle，代码更清爽：

func testReadJSONFile() {
    let filename = "yourFileName"
    
    guard let jsonURL = Bundle.module.url(forResource: filename, withExtension: "json") else {
        XCTFail("无法加载JSON文件：\(filename).json")
        return
    }
    
    // 读取并解析数据...
}

额外注意事项 #

• 确保你的JSON文件确实在测试目标的目录下，并且没有被exclude参数排除在外。
• Xcode 11 + Swift 5.1刚好支持Swift Package的资源处理，不需要升级环境就能正常使用。
• 修改Package.swift后，记得让Xcode重新加载Package（可以通过File菜单的Packages -> Update to Latest Package Versions操作，或者直接重启Xcode）。

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