如何在UIViewController或视图外部触发ViewController跳转？

你的核心需求是让独立于视图的业务单例在数据变化时触发视图导航，以下是针对问题的具体解决方案，同时回应你提到的几个思路：

关于你提出的思路的补充说明 #

1. Combine/通知方案并非权宜之计：这是UIKit中实现业务层与UI层解耦的标准做法，能避免业务逻辑依赖UI实例，符合分层架构设计。
2. 静态方法无法调用实例属性：navigationController是UIViewController的实例属性，静态方法属于类本身，自然无法直接调用，这个思路本身不符合UIKit的实例化调用逻辑。
3. UIKit中实现类似SwiftUI @ObservedObject的效果：可以通过Combine框架实现响应式监听，本质和第一个思路一致，让业务层发布状态变化，UI层订阅并做出响应。

具体实现方案 #

方案一：Combine响应式事件发布（推荐） #

通过Combine的PassthroughSubject让单例发布导航事件，起始ViewController订阅事件并执行导航操作，完全解耦业务层与UI层。

单例类代码：

import Combine

class ExampleManager: NSObject {
    static let shared = ExampleManager()
    // 定义导航目标枚举，明确跳转类型
    enum NavigationDestination {
        case main
        case onboarding
    }
    // 发布导航触发事件
    let navigationTrigger = PassthroughSubject<NavigationDestination, Never>()
    
    override init() {
        super.init()
        // 模拟延迟1秒判断首次启动逻辑
        DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in
            let isFirstLaunch = !UserDefaults.standard.bool(forKey: "hasLaunchedBefore")
            let destination = isFirstLaunch ? .onboarding : .main
            self?.navigationTrigger.send(destination)
            UserDefaults.standard.set(true, forKey: "hasLaunchedBefore")
        }
    }
}

起始ViewController代码：

import UIKit
import Combine

class InitialViewController: UIViewController {
    private var cancellables = Set<AnyCancellable>()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // 订阅导航事件，在主线程执行导航操作
        ExampleManager.shared.navigationTrigger
            .receive(on: DispatchQueue.main)
            .sink { [weak self] destination in
                guard let self = self, let navController = self.navigationController else { return }
                let targetVC: UIViewController
                switch destination {
                case .main:
                    targetVC = MainViewController() // 你的主页面
                case .onboarding:
                    targetVC = OnboardingViewController() // 你的引导页
                }
                navController.pushViewController(targetVC, animated: true)
            }
            .store(in: &cancellables)
    }
}

方案二：单例持有根导航控制器弱引用 #

适合单导航栈的简单应用，在App启动时将根导航控制器传给单例，单例直接调用导航方法，注意使用弱引用避免循环引用。

单例类代码：

class ExampleManager: NSObject {
    static let shared = ExampleManager()
    // 弱引用根导航控制器，避免内存泄漏
    weak var rootNavigationController: UINavigationController?
    
    override init() {
        super.init()
        DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in
            guard let navController = self?.rootNavigationController else { return }
            let isFirstLaunch = !UserDefaults.standard.bool(forKey: "hasLaunchedBefore")
            let targetVC = isFirstLaunch ? OnboardingViewController() : MainViewController()
            navController.pushViewController(targetVC, animated: true)
            UserDefaults.standard.set(true, forKey: "hasLaunchedBefore")
        }
    }
}

App启动时设置导航控制器：

// 在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)
    let initialVC = InitialViewController()
    let navController = UINavigationController(rootViewController: initialVC)
    window.rootViewController = navController
    window.makeKeyAndVisible()
    // 将根导航控制器传给单例
    ExampleManager.shared.rootNavigationController = navController
}

方案三：封装全局导航工具类 #

将导航逻辑抽离到专门的工具类，单例调用工具类的方法实现导航，进一步解耦业务逻辑与导航实现。

导航工具类代码：

class NavigationRouter {
    static let shared = NavigationRouter()
    weak var rootNavigationController: UINavigationController?
    
    // 封装push方法
    func push(_ viewController: UIViewController, animated: Bool = true) {
        rootNavigationController?.pushViewController(viewController, animated: animated)
    }
    
    // 可扩展其他导航方法，如pop、present等
}

单例类调用：

class ExampleManager: NSObject {
    static let shared = ExampleManager()
    
    override init() {
        super.init()
        DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
            let isFirstLaunch = !UserDefaults.standard.bool(forKey: "hasLaunchedBefore")
            let targetVC = isFirstLaunch ? OnboardingViewController() : MainViewController()
            NavigationRouter.shared.push(targetVC)
            UserDefaults.standard.set(true, forKey: "hasLaunchedBefore")
        }
    }
}

同样在App启动时设置NavigationRouter.shared.rootNavigationController = navController即可。

方案选择建议 #

• 优先选择方案一：完全遵循单一职责原则，业务层只负责处理逻辑并发布事件，UI层负责处理视图导航，解耦性最强，适合中大型项目。
• 小型单导航栈应用可选择方案二或方案三：实现简单直接，但要注意弱引用的内存管理，避免出现野指针问题。

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