如何制作类似Xcode的单主框架文档界面？求技术指引

核心逻辑：自定义 NSDocument 的窗口绑定 #

Xcode风格的单主框架界面，核心是跳出NSDocument默认的「一个文档对应一个独立窗口」逻辑，改为将所有文档内容嵌入到预先创建的主窗口容器中，全程复用同一个主窗口。

具体实现步骤 #

1. 重写 NSDocument 的窗口创建逻辑 #

在你的NSDocument子类中，重写makeWindowControllers()方法，不要调用父类默认实现，直接将文档的内容视图挂载到主窗口的容器里：

override func makeWindowControllers() {
    // 获取主窗口的容器视图（假设主窗口已在AppDelegate中初始化，容器视图标记tag=100）
    guard let mainWindow = NSApp.mainWindow,
          let containerView = mainWindow.contentView?.subviews.first(where: { $0.tag == 100 }) else {
        return
    }
    // 加载文档对应的内容视图控制器
    let contentVC = DocumentContentView()
    contentVC.bindDocument(self)
    // 将内容视图嵌入容器
    containerView.addSubview(contentVC.view)
    contentVC.view.frame = containerView.bounds
    contentVC.view.autoresizingMask = [.width, .height]
    // 绑定主窗口到当前文档
    addWindowController(NSWindowController(window: mainWindow))
}

2. 搭建主窗口基础架构 #

在AppDelegate的启动方法中，创建单例主窗口，通常用NSSplitView做左右分栏（左侧导航/项目面板，右侧文档容器）：

func applicationDidFinishLaunching(_ aNotification: Notification) {
    // 创建主窗口
    let mainWindow = NSWindow(
        contentRect: NSRect(x: 0, y: 0, width: 1200, height: 800),
        styleMask: [.titled, .closable, .resizable, .miniaturizable],
        backing: .buffered, defer: false
    )
    mainWindow.title = "My Xcode-Style App"
    
    // 初始化SplitView分栏
    let splitView = NSSplitView(frame: mainWindow.contentView!.bounds)
    splitView.autoresizingMask = [.width, .height]
    mainWindow.contentView?.addSubview(splitView)
    
    // 左侧导航面板
    let navPanel = NavigationPanel(frame: NSZeroRect)
    splitView.addSubview(navPanel)
    // 右侧文档容器（标记tag用于后续查找）
    let docContainer = NSView(frame: NSZeroRect)
    docContainer.tag = 100
    splitView.addSubview(docContainer)
    
    // 设置分栏宽度
    splitView.setPosition(250, ofDividerAt: 0)
    mainWindow.makeKeyAndOrderFront(nil)
}

3. 实现文档切换逻辑 #

在左侧导航面板的选中事件中，先清理当前文档的视图，再加载新文档：

// 导航面板选中文档的处理方法
func didSelectDocument(url: URL) {
    // 关闭当前显示的文档
    if let currentDoc = NSApp.orderedDocuments.first {
        currentDoc.close()
    }
    // 加载新文档（display参数设为false，避免触发默认窗口创建）
    NSDocumentController.shared.openDocument(withContentsOf: url, display: false) { (doc, _, _) in
        // 文档加载后会自动通过makeWindowControllers嵌入主容器
    }
}

4. 适配系统菜单与行为 #

• 重写NSDocumentController的相关方法（比如newDocument(_:)），确保新建文档时依然嵌入主容器，而非弹出新窗口。
• 保留NSDocument的核心逻辑（保存、撤销、版本管理等），这些功能不需要修改，只需确保文档实例与主窗口正确绑定。

官方参考方向 #

• 重点研读NSDocument类文档，理解文档与窗口控制器的绑定机制，以及自定义窗口创建的扩展点。
• 学习NSSplitView/NSTabView的布局管理，掌握容器视图的动态替换技巧。
• 查看macOS人机界面指南中「文档窗口」章节，了解单窗口文档界面的设计规范。

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