SwiftUI macOS文档App：如何创建主App结构体可访问的全局文档对象？

核心问题分析 #

你的GlobalDocDocument是结构体且遵循FileDocument，本身并非ObservableObject，因此无法直接使用@StateObject或@EnvironmentObject。另外DocumentGroup会自动管理文档实例的生命周期（比如新建、打开不同文档），不能在App层级硬编码全局文档对象。

实现步骤 #

1. 让文档支持可观察性 #

先修改文档定义，使其同时遵循ObservableObject，只有可观察对象才能通过环境传递或被视图监听：

import SwiftUI
import UniformTypeIdentifiers

struct GlobalDocDocument: FileDocument, ObservableObject {
    // 定义文档支持的类型，示例为纯文本
    static var readableContentTypes: [UTType] { [.plainText] }
    
    // 用@Published标记需要监听的文档属性
    @Published var content: String = ""
    
    // 初始化空文档
    init() {}
    
    // FileDocument协议要求：从文件读取内容初始化
    init(configuration: ReadConfiguration) throws {
        if let data = configuration.file.regularFileContents {
            content = String(decoding: data, as: UTF8.self)
        } else {
            content = ""
        }
    }
    
    // FileDocument协议要求：将文档内容写入文件
    func fileWrapper(configuration: WriteConfiguration) throws -> FileWrapper {
        let data = content.data(using: .utf8)!
        return .init(regularFileWithContents: data)
    }
}

2. 将文档注入视图环境 #

在DocumentGroup的闭包里，把当前文档实例注入到视图环境中，这样整个视图层级和命令都能访问：

@main
struct GlobalDocApp: App {
    var body: some Scene {
        DocumentGroup(newDocument: GlobalDocDocument()) { file in
            ContentView(document: file.$document)
                .environmentObject(file.document) // 把当前文档注入环境
        }
        .commands {
            CommandMenu("Custom Menu") {
                ModifyDocumentButton() // 将按钮抽为独立视图，用于访问环境对象
            }
        }
    }
}

3. 创建可访问环境文档的菜单项视图 #

CommandMenu闭包无法直接获取环境对象，因此需要把按钮做成独立的SwiftUI视图：

struct ModifyDocumentButton: View {
    @EnvironmentObject private var document: GlobalDocDocument
    
    var body: some View {
        Button("Modify it") {
            // 直接修改文档的@Published属性，触发视图刷新
            document.content += " Modified!"
        }
        // 仅当存在活跃文档时启用按钮
        .disabled(document.content.isEmpty)
    }
}

4. 在其他视图中访问文档 #

任何子视图只需声明@EnvironmentObject，就能直接访问当前窗口对应的文档实例：

struct ContentView: View {
    @Binding var document: GlobalDocDocument
    @EnvironmentObject private var sharedDocument: GlobalDocDocument // 可选，也可直接使用绑定
    
    var body: some View {
        TextEditor(text: $document.content)
            .padding()
    }
}

关键注意事项 #

• 不要在App层级创建全局文档实例，DocumentGroup会自动处理多文档场景（比如多窗口、多打开文档），每个窗口对应独立的文档实例，环境注入会自动匹配当前窗口的文档。
• 必须用@Published标记文档中需要监听的属性，这样修改时相关视图才会自动刷新。
• 菜单项按钮必须放在独立视图中，才能正确获取环境中的文档对象。

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