在使用自定义导航栏的SwiftUI DocumentGroup iCloud文档应用中，如何程序化重命名已打开的文档？

我完全明白你遇到的这个麻烦——用了SwiftUI的DocumentGroup做iCloud文档应用，自定义导航栏隐藏了系统默认的，结果自带的重命名功能用不了，自己试了FileManager、NSFileCoordinator这些方法不是权限报错就是无限挂起，确实头疼。

先给你拆解下为什么之前的方法都失败了：

• 直接用FileManager：iCloud Drive的文件操作必须通过苹果的文件协调机制，直接绕开它操作会触发权限限制，毕竟iCloud的同步需要系统统一管理。
• NSFileCoordinator传nil作为filePresenter：当前打开的文档本身就是一个NSFilePresenter（文件呈现器），系统已经在协调它的读写操作，你传nil的话，新的协调器拿不到锁，自然会挂起。
• Environment的rename值为nil：这个环境值是系统导航栏注入的，你把导航栏隐藏了，自然拿不到这个动作。

好在iOS 17+给我们提供了更简洁的官方解决方案，完全适配DocumentGroup和iCloud的要求，不需要折腾底层的协调逻辑：

首选方案：用FileDocumentConfiguration的move(to:)方法 #

在你的DocumentGroup闭包里，拿到的file参数其实是FileDocumentConfiguration<MyDocument>类型，它自带了move(to:completionHandler:)方法，这个方法会自动处理文件协调、iCloud同步，甚至更新文档的当前URL，完全不用你手动处理权限问题。

具体实现步骤 #

1. 把FileDocumentConfiguration实例传递给你的自定义导航栏（或者需要触发重命名的地方）：

// 在DocumentGroup的闭包里
ContentView(document: file.$document, fileConfiguration: file)
    .navigationBarHidden(true)

2. 在ContentView里定义重命名的方法：

struct ContentView: View {
    @Binding var document: MyDocument
    let fileConfiguration: FileDocumentConfiguration<MyDocument>
    
    // 比如自定义导航栏里的重命名按钮动作
    private func renameToNewName(_ newName: String) {
        let fileExtension = "cplan"
        // 构造新的URL：替换原URL的文件名
        guard let newURL = fileConfiguration.url.deletingLastPathComponent()
                .appendingPathComponent("\(newName).\(fileExtension)") else {
            return
        }
        
        // 调用move方法执行重命名
        fileConfiguration.move(to: newURL) { error in
            if let error = error {
                // 处理重命名失败的情况，比如弹个提示给用户
                print("重命名失败：\(error.localizedDescription)")
            } else {
                // 重命名成功，更新UI显示新文件名
                // 比如从newURL里提取文件名：newURL.deletingPathExtension().lastPathComponent
            }
        }
    }
    
    // 你的UI代码...
}

这个方法的好处是完全遵循苹果的文档架构，不需要自己处理复杂的文件协调逻辑，而且能在文档打开编辑的状态下安全执行重命名，用户体验不受影响。

备选方案：适配更早系统的NSFileCoordinator方法（iOS <17） #

如果需要支持iOS 17之前的版本，你可以通过NSFileCoordinator配合文档自身的NSFilePresenter身份来实现，但步骤会繁琐一些：

1. 让你的MyDocument显式遵循NSFilePresenter协议，保存当前文档的URL：

struct MyDocument: FileDocument, NSFilePresenter {
    // 你的文档内容属性...
    private var storedURL: URL?
    
    // NSFilePresenter要求的属性
    var presentedItemURL: URL? { storedURL }
    var presentedItemOperationQueue: OperationQueue { .main }
    
    init(configuration: ReadConfiguration) throws {
        // 读取文档内容的代码...
        self.storedURL = configuration.url
    }
    
    // 其他FileDocument协议方法（比如write配置）...
}

2. 在重命名时，用当前文档作为filePresenter初始化NSFileCoordinator：

private func renameToNewName(_ newName: String) {
    guard let currentURL = document.presentedItemURL else { return }
    let fileExtension = "cplan"
    guard let newURL = currentURL.deletingLastPathComponent()
            .appendingPathComponent("\(newName).\(fileExtension)") else {
        return
    }
    
    var coordinatorError: NSError?
    let coordinator = NSFileCoordinator(filePresenter: document)
    
    // 协调移动操作（重命名本质是移动文件到同一目录下的新文件名）
    coordinator.coordinate(
        writingItemAt: currentURL,
        options: .forMoving,
        writingItemAt: newURL,
        options: .forReplacing,
        error: &coordinatorError
    ) { sourceURL, destinationURL in
        do {
            try FileManager.default.moveItem(at: sourceURL, to: destinationURL)
            // 更新文档的URL
            document.storedURL = destinationURL
            // 通知协调器文件已移动
            coordinator.itemMoved(at: currentURL, to: destinationURL)
        } catch let moveError {
            print("移动文件失败：\(moveError)")
        }
    }
    
    if let error = coordinatorError {
        print("文件协调失败：\(error.localizedDescription)")
    }
}

注意事项 #

• 重命名时要确保新文件名在目标目录中不存在，或者处理覆盖逻辑（move(to:)方法默认会处理冲突，但你可以根据需求调整）。
• 重命名成功后，记得更新UI上显示的文档名称，比如从新URL中提取文件名。
• 完全不需要关闭文档再重命名，上述两种方法都能在文档打开编辑的状态下安全执行。

内容来源于stack exchange