macOS：如何通过代码实现Storyboard导航及打开ViewController窗口？

刚好之前做macOS开发时经常碰到这些场景，我来一步步给你拆解清楚：

在macOS里用代码操作Storyboard导航，核心是通过NSStoryboard实例化目标控制器，再根据场景切换视图：

• 1. 先拿到目标Storyboard实例
  假设你的Storyboard文件名为Main.storyboard，先实例化它：

  // Swift
  let storyboard = NSStoryboard(name: NSStoryboard.Name("Main"), bundle: nil)
  

  // Objective-C
  NSStoryboard *storyboard = [NSStoryboard storyboardWithName:@"Main" bundle:nil];
  

• 2. 实例化目标ViewController
  记得先给Storyboard里的目标ViewController设置好Storyboard ID（在Xcode的Identity Inspector面板里填写），比如叫UserProfileVC，然后用这个ID获取控制器：

  // Swift
  guard let targetVC = storyboard.instantiateController(withIdentifier: NSStoryboard.SceneIdentifier("UserProfileVC")) as? UserProfileViewController else {
      fatalError("无法实例化目标ViewController，请检查Storyboard ID是否正确")
  }
  

  // Objective-C
  UserProfileViewController *targetVC = [storyboard instantiateControllerWithIdentifier:@"UserProfileVC"];
  if (![targetVC isKindOfClass:[UserProfileViewController class]]) {
      NSAssert(NO, "无法实例化目标ViewController，请检查Storyboard ID");
      return;
  }
  

• 3. 实现具体导航跳转
  分两种常用场景：

  • 替换当前窗口的内容视图：如果只是在当前窗口内切换页面，直接替换窗口的contentViewController即可：

    // Swift
    if let mainWindow = NSApplication.shared.mainWindow {
        mainWindow.contentViewController = targetVC
    }
    

  • 层级式导航（带前进后退）：如果需要类似iOS的导航栈效果，先把初始控制器放进NSNavigationController，之后用push方法跳转：
    先初始化导航控制器（首次设置时用）：

    // Swift
    let navController = NSNavigationController(rootViewController: initialViewController)
    NSApplication.shared.mainWindow?.contentViewController = navController
    

    跳转目标页面：

    // Swift
    navController.pushViewController(targetVC, animated: true)
    

    后退则用navController.popViewController(animated: true)或者navController.popToRootViewController(animated: true)

答案是必须关联NSWindow——macOS里的ViewController本身不能独立显示，必须依附于NSWindow（通常通过NSWindowController管理）。这里有两种实现方式：

• 方式1：复用Storyboard里的Window Controller
  如果你已经在Storyboard里创建了NSWindowController（关联了NSWindow和目标ViewController），给这个Window Controller设置好Storyboard ID，直接实例化并显示：

  // Swift
  guard let windowController = storyboard.instantiateController(withIdentifier: NSStoryboard.SceneIdentifier("ProfileWindowController")) as? NSWindowController else {
      fatalError("无法实例化Window Controller，请检查ID")
  }
  windowController.showWindow(nil)
  

  // Objective-C
  NSWindowController *windowController = [storyboard instantiateControllerWithIdentifier:@"ProfileWindowController"];
  if (![windowController isKindOfClass:[NSWindowController class]]) {
      NSAssert(NO, "无法实例化Window Controller");
      return;
  }
  [windowController showWindow:nil];
  

  这种方式不需要手动创建NSWindow，Storyboard已经帮你配置好了窗口的大小、样式、布局等。

• 方式2：完全手动创建NSWindow和ViewController
  如果不想依赖Storyboard，完全从零构建：

  // Swift
  // 1. 创建目标ViewController
  let profileVC = UserProfileViewController()
  
  // 2. 创建NSWindow，设置窗口的位置、大小、样式
  let window = NSWindow(
      contentRect: NSRect(x: 200, y: 200, width: 600, height: 400),
      styleMask: [.titled, .closable, .resizable, .miniaturizable],
      backing: .buffered,
      defer: false
  )
  
  // 3. 将ViewController绑定到窗口
  window.contentViewController = profileVC
  
  // 4. 显示并激活窗口
  window.makeKeyAndOrderFront(nil)
  NSApplication.shared.activate(ignoringOtherApps: true)
  

  // Objective-C
  // 1. 创建ViewController
  UserProfileViewController *profileVC = [[UserProfileViewController alloc] init];
  
  // 2. 创建NSWindow
  NSRect contentRect = NSMakeRect(200, 200, 600, 400);
  NSWindow *window = [[NSWindow alloc] initWithContentRect:contentRect
                                                styleMask:(NSTitledWindowMask | NSClosableWindowMask | NSResizableWindowMask | NSMiniaturizableWindowMask)
                                                  backing:NSBackingStoreBuffered
                                                    defer:NO];
  
  // 3. 绑定ViewController
  [window setContentViewController:profileVC];
  
  // 4. 显示窗口
  [window makeKeyAndOrderFront:nil];
  [[NSApplication sharedApplication] activateIgnoringOtherApps:YES];
  

  这种方式就需要你手动创建NSWindow，并配置所有窗口属性（比如是否可缩放、是否有标题栏等）。

额外补充：模态窗口的打开方式 #

如果需要打开模态窗口（比如弹窗），可以用这两种方式：

• 作为Sheet显示在主窗口上：windowController.window?.beginSheet(completionHandler: { (response) in // 弹窗关闭后的回调 })
• 作为独立模态窗口：NSApplication.shared.runModal(for: window)

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