SwiftUI文档类macOS应用中如何获取选中文件的完整路径

核心说明 #

FileWrapper本身仅封装文件的内容和文件名，不存储文件的完整磁盘路径，无法直接从FileWrapper实例中读取全路径。

可行实现方案 #

方案1：使用系统原生属性（适配 macOS 13+/iOS 16+）

从上述系统版本开始，ReadConfiguration已经提供了公开的fileURL属性，直接读取即可拿到文件的完整路径：

struct MyDocument: FileDocument {
    var text: String
    // 新增属性存储完整路径
    var fullPath: String?

    init() {
        text = ""
    }

    static var readableContentTypes: [UTType] { [.myDocument] }

    init(configuration: ReadConfiguration) throws {
        // 直接读取全路径
        self.fullPath = configuration.fileURL?.path
        print("文件完整路径：\(fullPath ?? "")")
        
        // 原有文件内容读取逻辑
        guard let data = configuration.file.regularFileContents,
              let content = String(data: data, encoding: .utf8) else {
            throw CocoaError(.fileReadCorruptFile)
        }
        text = content
    }
    
    func fileWrapper(configuration: WriteConfiguration) throws -> FileWrapper {
        let data = text.data(using: .utf8)!
        return .init(regularFileWithContents: data)
    }
}

方案2：兼容旧系统版本

如果需要支持 macOS 12 及更早版本，可以在文件选择器的回调中直接获取选中文件的URL，再传入Document实例：

1. 首先给MyDocument新增存储路径的属性：

struct MyDocument: FileDocument {
    var text: String
    var fullPath: String?
    // 其余原有逻辑保持不变
}

2. 在.fileImporter的选择回调中捕获路径：

.fileImporter(
    allowedContentTypes: [.myDocument],
    allowsMultipleSelection: false
) { result in
    switch result {
    case .success(let urls):
        guard let fileURL = urls.first,
              // 申请沙盒访问权限
              fileURL.startAccessingSecurityScopedResource() else {
            return
        }
        defer {
            fileURL.stopAccessingSecurityScopedResource()
        }
        do {
            let fileWrapper = try FileWrapper(url: fileURL)
            var document = try MyDocument(configuration: .init(
                file: fileWrapper,
                contentType: .myDocument
            ))
            // 传入完整路径
            document.fullPath = fileURL.path
        } catch {
            // 处理读取错误
        }
    case .failure(let error):
        // 处理选择错误
    }
}

注意事项 #

• 受macOS沙盒机制限制，拿到路径后如果需要跨启动周期访问文件，建议存储安全作用域书签，不要直接持久化完整路径，避免用户移动文件后路径失效。

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