SwiftUI跨平台应用iOS端Bundle读取内部文件方法失效求助

DevOps 小满

2026-6-1

解决iOS端Bundle无法读取子目录文件的问题

问题核心

SwiftUI跨平台应用中，Mac端能正常通过Bundle.main.paths(forResourcesOfType:)或Bundle.main.urls(forResourcesWithExtension:)读取Bundle内子目录的文件，但iOS端返回空数组——即使模拟器包内容中明确存在目标文件夹及文件。

原因分析

iOS与Mac的Bundle资源处理逻辑存在差异：

Mac端默认会遍历Bundle内所有目录查找资源
iOS端需要明确指定子目录路径，否则只会在Bundle根目录查找；同时若文件夹以「组」（黄色图标）而非「文件夹引用」（蓝色图标）添加到项目，iOS会将文件平铺到Bundle根目录，丢失原文件夹结构

解决方案

1. 确认文件夹的Xcode添加方式

选中项目中的目标文件夹，查看右侧属性检查器：

确保「添加到目标」已勾选对应应用目标
选择「创建文件夹引用」（而非「创建组」），这样iOS Bundle会保留完整的文件夹结构

2. 修改资源读取代码

调用Bundle资源方法时，明确指定子目录参数：

使用paths(forResourcesOfType:inDirectory:)：

// 替换"YourFolderName"为实际文件夹名
guard let filePaths = Bundle.main.paths(forResourcesOfType: "json", inDirectory: "YourFolderName") else {
    print("未找到文件")
    return
}

使用urls(forResourcesWithExtension:subdirectory:)：

guard let fileURLs = Bundle.main.urls(forResourcesWithExtension: "json", subdirectory: "YourFolderName") else {
    print("未找到文件")
    return
}

3. FileManager读取的替代方案

如果需要通过FileManager枚举目录，需正确拼接子目录路径：

guard let folderURL = Bundle.main.url(forResource: "YourFolderName", withExtension: nil) else {
    print("未找到目标目录")
    return
}

do {
    let fileURLs = try FileManager.default.contentsOfDirectory(at: folderURL, includingPropertiesForKeys: nil)
    // 处理文件URL
} catch {
    print("读取目录失败：\(error)")
}