SwiftUI中如何打开并配置新窗口实现新标签页加载目标链接

全局静态变量传值的方案存在时序冲突、状态污染的隐患，不符合SwiftUI和WebKit的设计规范，以下是两种可直接落地的标准实现：

方案1：基于WKWebView原生回调实现（兼容性最佳，推荐） #

webView(_:createWebViewWith:for:windowFeatures:) 回调的设计逻辑本身就是让开发者返回新的WKWebView实例，WebKit会自动将目标链接加载到返回的实例中，不需要手动创建窗口后再传递URL，之前代码直接返回nil才是需要绕路传值的根源。

第一步：改造浏览器模型，统一管理WebView实例 #

class WebBrowserModel: NSObject, ObservableObject, WKUIDelegate {
    // 存储所有标签页对应的WebView
    @Published var tabs: [WKWebView] = []
    // 当前激活的标签页
    @Published var activeTab: WKWebView?
    
    override init() {
        super.init()
        let homeWebView = createWebView()
        // 加载默认首页
        homeWebView.load(URLRequest(url: URL(string: "https://www.w3schools.com/jsref/met_win_prompt.asp")!))
        tabs = [homeWebView]
        activeTab = homeWebView
    }
    
    // 统一WebView创建逻辑，自动绑定代理
    private func createWebView(configuration: WKWebViewConfiguration = .init()) -> WKWebView {
        let webView = WKWebView(frame: .zero, configuration: configuration)
        webView.uiDelegate = self
        return webView
    }
    
    // MARK: WKUIDelegate
    func webView(_ webView: WKWebView, createWebViewWith configuration: WKWebViewConfiguration, for navigationAction: WKNavigationAction, windowFeatures: WKWindowFeatures) -> WKWebView? {
        // 必须使用回调传入的configuration创建实例，否则会丢失Cookie、会话、权限等上下文
        let newWebView = createWebView(configuration: configuration)
        
        DispatchQueue.main.async { [weak self] in
            guard let self else { return }
            self.tabs.append(newWebView)
            self.activeTab = newWebView
            // 触发系统新建标签页
            NSApp.sendAction(#selector(NSWindowController.newWindowForTab(_:)), to: nil, from: nil)
            
            // 新窗口创建完成后将WebView挂载到对应窗口
            DispatchQueue.main.async {
                guard let newWindow = NSApp.windows.first(where: { $0.isKeyWindow }),
                      let contentView = newWindow.contentView,
                      !contentView.subviews.contains(where: { $0 is WKWebView }) else { return }
                newWebView.frame = contentView.bounds
                newWebView.autoresizingMask = [.width, .height]
                contentView.addSubview(newWebView)
            }
        }
        
        // 直接返回新WebView，WebKit自动加载目标链接，无需手动传值调用load
        return newWebView
    }
}

第二步：适配视图层 #

struct ContentView: View {
    @StateObject private var browserModel = WebBrowserModel()
    
    var body: some View {
        if let activeWebView = browserModel.activeTab {
            WebBrowser(webView: activeWebView)
        }
    }
}

struct WebBrowser: NSViewRepresentable {
    typealias NSViewType = WKWebView
    private let webView: WKWebView
    
    init(webView: WKWebView) {
        self.webView = webView
    }
    
    func makeNSView(context: Context) -> WKWebView { webView }
    func updateNSView(_ webView: WKWebView, context: Context) {}
}

该方案支持macOS 10.15+，完全遵循WebKit设计规范，不会出现链接和标签页不匹配的时序问题。

方案2：SwiftUI原生窗口管理实现（macOS 13+适用） #

如果项目最低支持macOS 13，可以完全抛弃AppKit手动窗口调用，用SwiftUI原生openWindow能力实现类型安全的传值：

第一步：定义窗口标识和传值模型 #

enum WindowID: String {
    case browserTab
}

struct TabContext: Codable, Hashable {
    let targetURL: URL
}

第二步：在App层注册窗口 #

struct WebBrowserApp: App {
    var body: some Scene {
        WindowGroup(id: WindowID.browserTab.rawValue, for: TabContext.self) { $context in
            ContentView(initialURL: context?.targetURL)
        }
    }
}

第三步：改造视图和模型，通过环境变量传值 #

struct ContentView: View {
    @Environment(\.openWindow) private var openWindow
    @StateObject private var browserModel = WebBrowserModel()
    let initialURL: URL?
    
    var body: some View {
        WebBrowser(webView: browserModel.webView)
            .frame(minWidth: 600, maxWidth: .infinity, minHeight: 800, maxHeight: .infinity)
            .onAppear {
                // 注入窗口打开方法到模型
                browserModel.openNewTab = { url in
                    openWindow(id: WindowID.browserTab.rawValue, value: TabContext(targetURL: url))
                }
                // 加载初始URL
                let targetURL = initialURL ?? URL(string: "https://www.w3schools.com/jsref/met_win_prompt.asp")!
                browserModel.webView.load(URLRequest(url: targetURL))
            }
    }
}

class WebBrowserModel: NSObject, ObservableObject, WKUIDelegate {
    lazy var webView: WKWebView = {
        let config = WKWebViewConfiguration()
        let webView = WKWebView(frame: .zero, configuration: config)
        webView.uiDelegate = self
        return webView
    }()
    
    var openNewTab: ((URL) -> Void)?
    
    func webView(_ webView: WKWebView, createWebViewWith configuration: WKWebViewConfiguration, for navigationAction: WKNavigationAction, windowFeatures: WKWindowFeatures) -> WKWebView? {
        guard let targetURL = navigationAction.request.url else { return nil }
        openNewTab?(targetURL)
        return nil
    }
}

该方案完全符合SwiftUI状态管理设计，没有全局变量，类型安全，代码可读性更高。

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