iOS模拟器中为何调用contentsOfDirectory获取文件URL为空？

认知偏差修正 #

• 沙盒路径随机化的本质：FileManager返回的Documents目录路径每次启动变化，是iOS系统的沙盒路径随机保护机制实现的，文件实体是持久存储的，不会因为路径前缀变化就生成全新的空目录，所有已经写入沙盒的文件在应用重启后，依然可以通过新生成的路径正常访问。
• 安全范围资源API的适用边界：startAccessingSecurityScopedResource()仅用于应用沙盒外、用户通过系统文件选择器授权的资源访问，对应用自身沙盒内的Documents、Library、tmp目录调用该API没有任何权限提升效果，若未配套调用stopAccessingSecurityScopedResource()，反而可能造成系统资源泄漏。
• 模拟器环境的API兼容性：contentsOfDirectory方法在iOS模拟器下的行为和真机完全一致，不存在环境层面的兼容性问题，也不会无理由返回空数组。

代码运行异常的根因 #

你当前逻辑下files数组为空，核心原因是文件从未被成功写入Documents目录：

• 调用copyItem(atPath:toPath:)时，目标路径直接传入了currentURL.path（也就是Documents目录本身的完整路径），没有在该路径基础上拼接源文件的文件名。系统检测到你要将单个文件复制到“和Documents目录同名”的位置，自然会抛出“文件已存在”的错误——因为Documents目录本身就已经在这个路径上存在，整个复制操作从始至终没有执行成功，自然没有文件可以被目录遍历方法捕获。
• 你在Mac上向模拟器导入文件时看到的“同名文件已存在”提示，是模拟器文件传输流程的前置校验逻辑，不代表文件已经成功写入当前运行应用的沙盒Documents目录，两者的路径校验是独立的。

修正后的可运行代码 #

let document_files: [String] = [
    "/Users/james/Documents/Apple_Developer_Program_License_Agreement_XV2A27GUJ6.pdf",
    "/Users/james/Documents/BH_US_11_Sullivan_Server_Side_WP.pdf",
    "/Users/james/Documents/Classical and Quantum Singularities of Levi-Civita Spacetimes.pdf"
]

let fileManager = FileManager.default
// 获取Documents目录路径，沙盒内资源无需调用安全范围权限API
let documentsURL = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first!

for documentPath in document_files {
    // 构造源文件与目标文件的完整路径（必须拼接目标文件名）
    let sourceFileURL = URL(fileURLWithPath: documentPath)
    let targetFileURL = documentsURL.appendingPathComponent(sourceFileURL.lastPathComponent)
    
    do {
        // 若目标位置已存在同名文件，先删除避免冲突
        if fileManager.fileExists(atPath: targetFileURL.path) {
            try fileManager.removeItem(at: targetFileURL)
        }
        try fileManager.copyItem(at: sourceFileURL, to: targetFileURL)
    } catch {
        print("文件复制失败：\(error.localizedDescription)")
    }
}

do {
    // 遍历Documents目录下的所有文件
    let files = try fileManager.contentsOfDirectory(
        at: documentsURL,
        includingPropertiesForKeys: [.nameKey],
        options: .skipsHiddenFiles
    )
    print("目录下文件总数：\(files.count)")
    for file in files {
        print("文件完整路径：\(file.path)")
    }
} catch {
    print("目录读取失败：\(error.localizedDescription)")
}

模拟器文件提取的操作说明 #

• 代码层面：按照上述修正逻辑调用contentsOfDirectory，即可正常获取当前应用沙盒Documents目录下的所有文件URL数组，无需额外申请权限。
• 手动层面：在Xcode的「设备和模拟器」面板中，找到对应运行的应用，进入其沙盒的Documents目录，即可直接拖拽导出目录下的所有文件，不需要依赖代码遍历。

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