如何从AppDelegate跳转至ViewController及启动跳转失败问题排查

问题1：如何从AppDelegate跳转到ViewController？ #

从AppDelegate跳转主要分两种场景，我给你整理了最常用的两种实现方式：

方式1：启动时直接替换根控制器 #

如果是App刚启动就要跳转到目标页面，直接修改window的根控制器即可，要是需要导航栏支持，记得用导航控制器包裹目标页面：

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 初始化目标ViewController，用xib的话替换对应nibName参数
    let targetVC = YourTargetViewController(nibName: nil, bundle: nil)
    // 包裹导航控制器（可选，根据需求决定）
    let navController = UINavigationController(rootViewController: targetVC)
    // 设置为根控制器并显示
    self.window?.rootViewController = navController
    self.window?.makeKeyAndVisible()
    return true
}

方式2：App运行中从根控制器跳转 #

如果App已经处于运行状态，有现成的根控制器，就从根控制器入手跳转：

• 若根控制器是导航控制器，直接push：

// 先确认根控制器类型为导航控制器
guard let rootNav = self.window?.rootViewController as? UINavigationController else {
    print("根控制器不是导航控制器，无法执行push跳转")
    return
}
let targetVC = YourTargetViewController()
rootNav.pushViewController(targetVC, animated: true)

• 若根控制器是普通ViewController，用present方式：

guard let rootVC = self.window?.rootViewController else {
    print("无法获取根控制器")
    return
}
let targetVC = YourTargetViewController()
rootVC.present(targetVC, animated: true)

问题2：启动时检查UserDefaults值但无法跳转的问题 #

你提到能获取到UserDefaults的值但跳转失效，大概率是跳转时机不对或者window/根控制器的初始化逻辑冲突，我给你梳理了常见问题和解决办法：

常见原因1：iOS13+启用了SceneDelegate，AppDelegate里的window无效 #

从iOS13开始，苹果把窗口管理逻辑移到了SceneDelegate中，如果你的项目启用了Scene功能，AppDelegate里的window对象是空的，修改它根本不会生效！

解决办法：把跳转逻辑移到SceneDelegate.swift的scene(_:willConnectTo:options:)方法中：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }
    
    // 手动初始化window对象
    let window = UIWindow(windowScene: windowScene)
    self.window = window
    
    let defaults = UserDefaults.standard
    let active = defaults.bool(forKey: "active")
    
    if active {
        // 跳转到目标页面
        let targetVC = TargetViewController(nibName: nil, bundle: nil)
        let navVC = UINavigationController(rootViewController: targetVC)
        window.rootViewController = navVC
    } else {
        // 跳转到默认初始页面
        let defaultVC = InitialViewController(nibName: nil, bundle: nil)
        window.rootViewController = defaultVC
    }
    // 必须调用此方法让window显示
    window.makeKeyAndVisible()
}

常见原因2：项目依赖Storyboard，系统自动初始化了根控制器 #

如果你的项目使用Storyboard（Info.plist中设置了Main storyboard file base name），系统会自动创建根控制器，你后续在AppDelegate中修改window.rootViewController可能被系统覆盖。

解决办法：手动从Storyboard获取控制器，再替换根控制器：

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let defaults = UserDefaults.standard
    let active = defaults.bool(forKey: "active")
    
    let storyboard = UIStoryboard(name: "Main", bundle: nil)
    var rootVC: UIViewController
    
    if active {
        // 注意：必须给目标VC在Storyboard中设置正确的Storyboard ID
        rootVC = storyboard.instantiateViewController(withIdentifier: "TargetVC")
    } else {
        // 获取Storyboard默认的初始控制器
        rootVC = storyboard.instantiateInitialViewController()!
    }
    
    // 包裹导航控制器（可选）
    let navVC = UINavigationController(rootViewController: rootVC)
    self.window?.rootViewController = navVC
    self.window?.makeKeyAndVisible()
    
    return true
}

额外检查点 #

• 确认UserDefaults的键名完全匹配，你可以打印print(defaults.dictionaryRepresentation())查看所有存储的键值对，确保"active"存在且值正确
• 如果用Storyboard跳转，务必给目标ViewController设置Storyboard ID（在Xcode的Identity Inspector面板中配置）

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