iOS Swift：以编程方式启动ViewController的最佳规范方法咨询

嘿，这个问题问到点子上了——这正是iOS开发中导航流程设计的核心场景之一，我结合Swift的最佳实践给你拆解下：

一、登录验证通过后跳转至ListViewController #

通常登录页是应用的初始入口，验证成功后不应该让用户再通过返回回到登录页，所以最优方案是直接替换window的rootViewController，而不是简单的push（避免导航栈残留登录页）。

实现代码（iOS 13+，基于SceneDelegate） #

在LoginViewController的API异步回调中处理：

// 假设API验证成功的闭包回调
func handleLoginSuccess() {
    DispatchQueue.main.async { // UI操作必须在主线程执行
        // 创建ListVC并包装在导航控制器中（方便后续跳转ItemVC）
        let listVC = ListViewController()
        let navController = UINavigationController(rootViewController: listVC)
        
        // 获取当前应用的主window
        guard let scene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
              let window = scene.windows.first else { return }
        
        // 替换root并添加过渡动画提升体验
        UIView.transition(with: window, duration: 0.3, options: .transitionCrossDissolve) {
            window.rootViewController = navController
        }
    }
}

如果需要兼容iOS 12及以下，只需把获取window的代码换成AppDelegate的self.window即可。

二、通过链接/远程通知直接启动ItemViewController #

这种场景属于深层链接，需要区分两种情况：应用未启动时的冷启动，以及应用在后台时的热唤醒，处理逻辑略有不同。

第一步：统一创建导航栈的工具方法 #

先封装一个方法，确保不管哪种启动方式，导航栈的结构都是一致的（ListViewController作为根，ItemViewController在其上方）：

// 可以放在SceneDelegate或者单独的导航管理类中
func setupItemNavigationStack(with itemId: String) {
    // 推荐用带参数的初始化方法，强制传递必要数据
    let itemVC = ItemViewController(itemId: itemId)
    let listVC = ListViewController()
    
    let navController = UINavigationController(rootViewController: listVC)
    navController.pushViewController(itemVC, animated: false) // 冷启动时不需要动画
    
    // 设置为root
    guard let scene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
          let window = scene.windows.first else { return }
    window.rootViewController = navController
}

第二步：处理链接启动（UIApplicationOpenURLOptionsKey） #

1. 冷启动场景（应用未运行）

在SceneDelegate的scene(_:willConnectTo:options:)中处理：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = scene as? UIWindowScene else { return }
    let window = UIWindow(windowScene: windowScene)
    self.window = window
    
    // 检查是否有启动链接
    if let urlContext = connectionOptions.urlContexts.first {
        let url = urlContext.url
        // 解析链接中的itemId（示例链接格式：myapp://item?id=123）
        if let itemId = url.queryParameters?["id"] {
            setupItemNavigationStack(with: itemId)
            window.makeKeyAndVisible()
            return
        }
    }
    
    // 无链接时默认启动登录页
    let loginVC = LoginViewController()
    window.rootViewController = loginVC
    window.makeKeyAndVisible()
}

// 扩展URL，方便解析query参数
extension URL {
    var queryParameters: [String: String]? {
        guard let components = URLComponents(url: self, resolvingAgainstBaseURL: true),
              let queryItems = components.queryItems else { return nil }
        return queryItems.reduce(into: [String: String]()) { dict, item in
            dict[item.name] = item.value
        }
    }
}

2. 热唤醒场景（应用在后台）

在SceneDelegate的scene(_:openURLContexts:)中处理：

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let urlContext = URLContexts.first else { return }
    let url = urlContext.url
    
    if let itemId = url.queryParameters?["id"],
       let navController = window?.rootViewController as? UINavigationController {
        // 先回到ListVC（避免重复push或栈结构混乱）
        for vc in navController.viewControllers {
            if vc is ListViewController {
                navController.popToViewController(vc, animated: false)
                break
            }
        }
        // 跳转到ItemVC
        let itemVC = ItemViewController(itemId: itemId)
        navController.pushViewController(itemVC, animated: true)
    }
}

第三步：处理远程通知启动 #

1. 冷启动场景

同样在SceneDelegate的scene(_:willConnectTo:options:)中添加判断：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    // ... 前面的链接检查代码 ...
    
    // 检查是否有启动通知
    if let remoteNotification = connectionOptions.remoteNotification {
        if let itemId = remoteNotification.userInfo["itemId"] as? String {
            setupItemNavigationStack(with: itemId)
            window.makeKeyAndVisible()
            return
        }
    }
    
    // 默认启动登录页
    // ...
}

2. 热唤醒场景

在SceneDelegate的scene(_:didReceiveRemoteNotification:fetchCompletionHandler:)中处理：

func scene(_ scene: UIScene, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    if let itemId = userInfo["itemId"] as? String,
       let navController = window?.rootViewController as? UINavigationController {
        // 确保回到ListVC后再跳转
        for vc in navController.viewControllers {
            if vc is ListViewController {
                navController.popToViewController(vc, animated: false)
                break
            }
        }
        let itemVC = ItemViewController(itemId: itemId)
        navController.pushViewController(itemVC, animated: true)
    }
    completionHandler(.newData) // 通知系统处理结果
}

几个关键注意点 #

• 主线程操作：所有修改UI或导航栈的代码必须放在DispatchQueue.main.async中，避免线程冲突。
• 导航栈一致性：不管哪种启动方式，都要保证ItemViewController始终在ListViewController的上方，确保用户返回逻辑符合预期。
• 参数安全性：推荐用带参数的初始化方法创建ItemViewController，避免依赖可选属性导致空值问题。
• iOS版本兼容：如果需要支持iOS 12及以下，需在AppDelegate中对应处理application(_:didFinishLaunchingWithOptions:)等方法，逻辑和SceneDelegate一致。

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