如何避免加载SwiftUI预览时打开AppKit应用主窗口？

核心思路 #

AppKit没有iOS/Catalyst的SceneDelegate，但可以通过检测Xcode预览专属的环境变量，在应用启动阶段精准跳过主窗口初始化逻辑，同时保证SwiftUI预览能正常加载目标视图或AppKit视图控制器。

具体实现方案 #

1. 在AppDelegate中拦截预览启动 #

Xcode启动预览时会自动设置XCODE_RUNNING_FOR_PREVIEWS环境变量（值为1），我们可以在applicationDidFinishLaunching(_:)中基于这个变量判断环境：

func applicationDidFinishLaunching(_ aNotification: Notification) {
    let isPreview = ProcessInfo.processInfo.environment["XCODE_RUNNING_FOR_PREVIEWS"] == "1"
    guard !isPreview else { return }
    
    // 仅在非预览模式下执行主窗口初始化
    let mainWindow = NSWindow(
        contentRect: NSRect(x: 0, y: 0, width: 800, height: 600),
        styleMask: [.titled, .closable, .miniaturizable, .resizable],
        backing: .buffered, defer: false
    )
    mainWindow.center()
    mainWindow.makeKeyAndOrderFront(nil)
    NSApp.activate(ignoringOtherApps: true)
}

2. 安全预览AppKit视图/控制器 #

为旧的AppKit组件编写SwiftUI包装器时，直接初始化目标实例，不要依赖主应用的全局状态，避免触发不必要的初始化逻辑：

// SwiftUI包装器
struct LegacyViewControllerPreview: View {
    var body: some View {
        LegacyVCWrapper()
    }
}

struct LegacyVCWrapper: NSViewControllerRepresentable {
    typealias NSViewControllerType = LegacyViewController
    
    func makeNSViewController(context: Context) -> LegacyViewController {
        // 直接初始化，不依赖AppDelegate的全局配置
        LegacyViewController()
    }
    
    func updateNSViewController(_ vc: LegacyViewController, context: Context) {
        // 按需更新视图控制器状态
    }
}

// 预览声明
struct LegacyViewControllerPreview_Previews: PreviewProvider {
    static var previews: some View {
        LegacyViewControllerPreview()
    }
}

3. 自定义启动入口（进阶优化） #

如果想完全隔离预览环境与主应用逻辑，可以修改应用的启动入口文件（通常是main.swift）：

import AppKit

let isPreview = ProcessInfo.processInfo.environment["XCODE_RUNNING_FOR_PREVIEWS"] == "1"

if isPreview {
    // 预览模式下，启动空的NSApplication实例，不加载AppDelegate
    NSApplication.shared.run()
} else {
    // 常规启动流程
    NSApplicationMain(CommandLine.argc, CommandLine.unsafeArgv)
}

这种方式可以彻底跳过AppDelegate的初始化，适合主应用启动逻辑复杂的场景。

方案优势 #

• 依赖Xcode官方的预览环境变量，比自定义临时标记更稳定，不会随Xcode版本更新失效。
• 逻辑解耦，预览与主应用的启动流程完全隔离，避免代码中混入冗余的临时判断。

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